/usr/share/doc/gdl-coyote/html/cgsourcedir.html is in gdl-coyote 2016.11.13-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 | <html>
<head>
<TITLE>coyote: CGSOURCEDIR</TITLE>
<style>
dt {font-weight: bold;}
</style>
</head>
<body>
<H1><a href="index.html">coyote</a>: CGSOURCEDIR</H1>
<ul>
<li><a href=Utilities.html>coyote/Utilities</a></li>
<li><a href="/usr/share/gnudatalanguage/coyote/cgsourcedir.pro">[Source code]</a></li>
</ul>
<dl>
<dt>Description</dt>
<dd><pre>
The purpose of this function is to provide a portable way of finding
the source directory of a program distribution. The directory that is returned
is the directory in which the source file using cgSourceDir() resides.
The program is useful for distributing applications that have a large number
of files in specific program directories (e.g., source, resources, data, etc.).
</pre></dd>
</dl>
<dl>
<dt>Categories</dt>
<dd><pre>
Utilities
</pre></dd>
</dl>
<dl>
<dt>Keywords</dt>
<dd><pre>
nomark: in, optional, type=boolean, default=0
Normally, the source directory name is returned with a final path
separator added to the end of the directory name. Setting this keyword
will suppress this final path separator.
oneup: in, optional, type=boolean, default=0
Setting this keyword will return the directory just above the source
directory in the file hierarchy.
twoup: in, optional, type=boolean, default=0
Setting this keyword will return the directory two directories above the source
directory in the file hierarchy.
</pre></dd>
</dl>
<dl>
<dt>Examples</dt>
<dd><pre>
Assume that your application files (and source programs) reside in this root directory::
../app
You have placed a DATA directory immediately under the APP directiory, and a RESOURCES
directory immedately under the DATA directory. Your directory structure looks like this::
../app ; Contains your application and source (*.pro) files.
../app/data ; Contains your application data files.
...app/data/resources ; Contains your application resource files.
The end user can install the APP directory wherever he or she likes. In your
program, you will identify the DATA and RESOURCES directory like this::
; Get icon image in resources directory.
filename = Filepath(Root_Dir=cgSourceDir(), Subdirectory=['data','resources'], 'myicon.tif')
; Get default image in data directory.
filename = Filepath(Root_Dir=cgSourceDir(), Subdirectory='data', 'ctscan.tif')
Alternatively, you might set up an application directory structure like this::
../app ; Contains your application files.
../app/source ; Contains your application source (*.pro) files.
../app/data ; Contains your application data files.
...app/data/resources ; Contains your application resource files.
In this case, you would use the ONEUP keyword to find your data and resource files, like this::
; Get icon image in resources directory.
filename = Filepath(Root_Dir=cgSourceDir(/ONEUP), Subdirectory=['data','resources'], 'myicon.tif')
; Get default image in data directory.
filename = Filepath(Root_Dir=cgSourceDir(/ONEUP), Subdirectory='data', 'ctscan.tif')
</pre></dd>
</dl>
<dl>
<dt>Author</dt>
<dd><pre>
FANNING SOFTWARE CONSULTING::
David W. Fanning
1645 Sheely Drive
Fort Collins, CO 80526 USA
Phone: 970-221-0438
E-mail: david@idlcoyote.com
Coyote's Guide to IDL Programming: http://www.idlcoyote.com
</pre></dd>
</dl>
<dl>
<dt>History</dt>
<dd><pre>
Change History::
Written by: David W. Fanning, 23 November 2003. Based on program SOURCEROOT, written by
Jim Pendleton at RSI (http://www.rsinc.com/codebank/search.asp?FID=35).
Added ONEUP keyword. 10 December 2003. DWF.
Added TWOUP keyword. 8 June 2007. DWF.
Added NOMARK keyword. 8 June 2007. DWF.
Renamed from ProgramRootDir and updated to cgSourceDir. 27 Jan 2014. DWF.
</pre></dd>
</dl>
<dl>
<dt>Copyright</dt>
<dd><pre>
Copyright (c) 2003-2014, Fanning Software Consulting, Inc.
</pre></dd>
</dl>
</body>
</html>
|