annotate scripts/miscellaneous/path.m @ 4942:a0f2839f6ac8

[project @ 2004-08-28 01:29:39 by jwe]
author jwe
date Sat, 28 Aug 2004 01:29:39 +0000
parents eaa2caaa35d6
children 4c8a2e4e0717
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
3017
d7edf1442471 [project @ 1997-06-03 17:15:39 by jwe]
jwe
parents:
diff changeset
1 ## Copyright (C) 1997 John W. Eaton
d7edf1442471 [project @ 1997-06-03 17:15:39 by jwe]
jwe
parents:
diff changeset
2 ##
d7edf1442471 [project @ 1997-06-03 17:15:39 by jwe]
jwe
parents:
diff changeset
3 ## This file is part of Octave.
d7edf1442471 [project @ 1997-06-03 17:15:39 by jwe]
jwe
parents:
diff changeset
4 ##
d7edf1442471 [project @ 1997-06-03 17:15:39 by jwe]
jwe
parents:
diff changeset
5 ## Octave is free software; you can redistribute it and/or modify it
d7edf1442471 [project @ 1997-06-03 17:15:39 by jwe]
jwe
parents:
diff changeset
6 ## under the terms of the GNU General Public License as published by
d7edf1442471 [project @ 1997-06-03 17:15:39 by jwe]
jwe
parents:
diff changeset
7 ## the Free Software Foundation; either version 2, or (at your option)
d7edf1442471 [project @ 1997-06-03 17:15:39 by jwe]
jwe
parents:
diff changeset
8 ## any later version.
d7edf1442471 [project @ 1997-06-03 17:15:39 by jwe]
jwe
parents:
diff changeset
9 ##
d7edf1442471 [project @ 1997-06-03 17:15:39 by jwe]
jwe
parents:
diff changeset
10 ## Octave is distributed in the hope that it will be useful, but
d7edf1442471 [project @ 1997-06-03 17:15:39 by jwe]
jwe
parents:
diff changeset
11 ## WITHOUT ANY WARRANTY; without even the implied warranty of
d7edf1442471 [project @ 1997-06-03 17:15:39 by jwe]
jwe
parents:
diff changeset
12 ## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
d7edf1442471 [project @ 1997-06-03 17:15:39 by jwe]
jwe
parents:
diff changeset
13 ## General Public License for more details.
d7edf1442471 [project @ 1997-06-03 17:15:39 by jwe]
jwe
parents:
diff changeset
14 ##
d7edf1442471 [project @ 1997-06-03 17:15:39 by jwe]
jwe
parents:
diff changeset
15 ## You should have received a copy of the GNU General Public License
d7edf1442471 [project @ 1997-06-03 17:15:39 by jwe]
jwe
parents:
diff changeset
16 ## along with Octave; see the file COPYING. If not, write to the Free
d7edf1442471 [project @ 1997-06-03 17:15:39 by jwe]
jwe
parents:
diff changeset
17 ## Software Foundation, 59 Temple Place - Suite 330, Boston, MA
d7edf1442471 [project @ 1997-06-03 17:15:39 by jwe]
jwe
parents:
diff changeset
18 ## 02111-1307, USA.
d7edf1442471 [project @ 1997-06-03 17:15:39 by jwe]
jwe
parents:
diff changeset
19
3449
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3426
diff changeset
20 ## -*- texinfo -*-
3500
7923abdeb4e5 [project @ 2000-01-31 06:35:00 by jwe]
jwe
parents: 3449
diff changeset
21 ## @deftypefn {Function File} {} path (@dots{})
3449
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3426
diff changeset
22 ## Modify or display Octave's @code{LOADPATH}.
3017
d7edf1442471 [project @ 1997-06-03 17:15:39 by jwe]
jwe
parents:
diff changeset
23 ##
3449
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3426
diff changeset
24 ## If @var{nargin} and @var{nargout} are zero, display the elements of
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3426
diff changeset
25 ## Octave's @code{LOADPATH} in an easy to read format.
3017
d7edf1442471 [project @ 1997-06-03 17:15:39 by jwe]
jwe
parents:
diff changeset
26 ##
3449
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3426
diff changeset
27 ## If @var{nargin} is zero and nargout is greater than zero, return the
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3426
diff changeset
28 ## current value of @code{LOADPATH}.
3017
d7edf1442471 [project @ 1997-06-03 17:15:39 by jwe]
jwe
parents:
diff changeset
29 ##
3449
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3426
diff changeset
30 ## If @var{nargin} is greater than zero, concatenate the arguments,
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3426
diff changeset
31 ## separating them with @code{":"}. Set @code{LOADPATH} to the result
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3426
diff changeset
32 ## and also return it.
3017
d7edf1442471 [project @ 1997-06-03 17:15:39 by jwe]
jwe
parents:
diff changeset
33 ##
d7edf1442471 [project @ 1997-06-03 17:15:39 by jwe]
jwe
parents:
diff changeset
34 ## No checks are made for duplicate elements.
3449
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3426
diff changeset
35 ## @end deftypefn
3017
d7edf1442471 [project @ 1997-06-03 17:15:39 by jwe]
jwe
parents:
diff changeset
36
d7edf1442471 [project @ 1997-06-03 17:15:39 by jwe]
jwe
parents:
diff changeset
37 ## Author: jwe
d7edf1442471 [project @ 1997-06-03 17:15:39 by jwe]
jwe
parents:
diff changeset
38
4688
eaa2caaa35d6 [project @ 2004-01-07 21:54:56 by jwe]
jwe
parents: 4629
diff changeset
39 function retval = path (varargin)
3017
d7edf1442471 [project @ 1997-06-03 17:15:39 by jwe]
jwe
parents:
diff changeset
40
4688
eaa2caaa35d6 [project @ 2004-01-07 21:54:56 by jwe]
jwe
parents: 4629
diff changeset
41 if (nargin > 0)
3979
e0b7a493e5a8 [project @ 2002-07-10 17:45:34 by jwe]
jwe
parents: 3500
diff changeset
42 p = varargin{1};
3017
d7edf1442471 [project @ 1997-06-03 17:15:39 by jwe]
jwe
parents:
diff changeset
43 for i = 2:nargin
3979
e0b7a493e5a8 [project @ 2002-07-10 17:45:34 by jwe]
jwe
parents: 3500
diff changeset
44 p = sprintf ("%s:%s", p, varargin{i});
3017
d7edf1442471 [project @ 1997-06-03 17:15:39 by jwe]
jwe
parents:
diff changeset
45 endfor
d7edf1442471 [project @ 1997-06-03 17:15:39 by jwe]
jwe
parents:
diff changeset
46 LOADPATH = p;
d7edf1442471 [project @ 1997-06-03 17:15:39 by jwe]
jwe
parents:
diff changeset
47 endif
d7edf1442471 [project @ 1997-06-03 17:15:39 by jwe]
jwe
parents:
diff changeset
48
4688
eaa2caaa35d6 [project @ 2004-01-07 21:54:56 by jwe]
jwe
parents: 4629
diff changeset
49 if (LOADPATH(1) == ":")
eaa2caaa35d6 [project @ 2004-01-07 21:54:56 by jwe]
jwe
parents: 4629
diff changeset
50 p = strcat (DEFAULT_LOADPATH, LOADPATH);
eaa2caaa35d6 [project @ 2004-01-07 21:54:56 by jwe]
jwe
parents: 4629
diff changeset
51 else
eaa2caaa35d6 [project @ 2004-01-07 21:54:56 by jwe]
jwe
parents: 4629
diff changeset
52 t = findstr (LOADPATH, "::");
eaa2caaa35d6 [project @ 2004-01-07 21:54:56 by jwe]
jwe
parents: 4629
diff changeset
53 if (any (t))
eaa2caaa35d6 [project @ 2004-01-07 21:54:56 by jwe]
jwe
parents: 4629
diff changeset
54 loc = t(1);
eaa2caaa35d6 [project @ 2004-01-07 21:54:56 by jwe]
jwe
parents: 4629
diff changeset
55 p = strcat (LOADPATH(1:loc), DEFAULT_LOADPATH, LOADPATH(loc+1:end));
eaa2caaa35d6 [project @ 2004-01-07 21:54:56 by jwe]
jwe
parents: 4629
diff changeset
56 elseif (LOADPATH(end) == ":")
eaa2caaa35d6 [project @ 2004-01-07 21:54:56 by jwe]
jwe
parents: 4629
diff changeset
57 p = strcat (LOADPATH, DEFAULT_LOADPATH);
eaa2caaa35d6 [project @ 2004-01-07 21:54:56 by jwe]
jwe
parents: 4629
diff changeset
58 else
eaa2caaa35d6 [project @ 2004-01-07 21:54:56 by jwe]
jwe
parents: 4629
diff changeset
59 p = LOADPATH;
eaa2caaa35d6 [project @ 2004-01-07 21:54:56 by jwe]
jwe
parents: 4629
diff changeset
60 endif
eaa2caaa35d6 [project @ 2004-01-07 21:54:56 by jwe]
jwe
parents: 4629
diff changeset
61 endif
eaa2caaa35d6 [project @ 2004-01-07 21:54:56 by jwe]
jwe
parents: 4629
diff changeset
62
eaa2caaa35d6 [project @ 2004-01-07 21:54:56 by jwe]
jwe
parents: 4629
diff changeset
63 if (nargin == 0 && nargout == 0)
eaa2caaa35d6 [project @ 2004-01-07 21:54:56 by jwe]
jwe
parents: 4629
diff changeset
64 puts ("\nOctave's search path contains the following directories:\n\n ");
eaa2caaa35d6 [project @ 2004-01-07 21:54:56 by jwe]
jwe
parents: 4629
diff changeset
65 puts (strrep (p, ":", "\n "));
eaa2caaa35d6 [project @ 2004-01-07 21:54:56 by jwe]
jwe
parents: 4629
diff changeset
66 puts ("\n\n");
eaa2caaa35d6 [project @ 2004-01-07 21:54:56 by jwe]
jwe
parents: 4629
diff changeset
67 else
eaa2caaa35d6 [project @ 2004-01-07 21:54:56 by jwe]
jwe
parents: 4629
diff changeset
68 retval = p;
eaa2caaa35d6 [project @ 2004-01-07 21:54:56 by jwe]
jwe
parents: 4629
diff changeset
69 endif
eaa2caaa35d6 [project @ 2004-01-07 21:54:56 by jwe]
jwe
parents: 4629
diff changeset
70
3017
d7edf1442471 [project @ 1997-06-03 17:15:39 by jwe]
jwe
parents:
diff changeset
71 endfunction