Mercurial > hg > octave-nkf
changeset 17017:8003a4f013be
Announce new prefdir, preferences functions and add to manual.
* NEWS: Add prefdir, preferences to list of new functions for 3.8.
* doc/interpreter/gui.txi: Add prefdir, preferences to manual.
* scripts/help/__unimplemented__.m: Remove functions from list of unimplemented.
* scripts/prefs/prefdir.m: Add @seealso references to docstring.
* scripts/prefs/preferences.m: Use prefsfile() instead of creating name.
* scripts/prefs/private/prefsfile.m: Use filesep() instead of '/' for Windows
users.
author | Rik <rik@octave.org> |
---|---|
date | Fri, 19 Jul 2013 10:12:43 -0700 |
parents | a3f6790df115 |
children | abe91fe896a8 |
files | NEWS doc/interpreter/gui.txi scripts/help/__unimplemented__.m scripts/prefs/prefdir.m scripts/prefs/preferences.m scripts/prefs/private/prefsfile.m |
diffstat | 6 files changed, 39 insertions(+), 39 deletions(-) [+] |
line wrap: on
line diff
--- a/NEWS +++ b/NEWS @@ -191,19 +191,19 @@ atan2d erfcinv lines base64_decode erfi polyeig - base64_encode expint readline_re_read_init_file - betaincinv findfigs readline_read_init_file - built_in_docstrings_file flintmax rgbplot - cmpermute fminsearch save_default_options - cmunique gallery shrinkfaces - colorcube gco splinefit - copyobj hdl2struct stemleaf - dawson history_save strjoin - dblist imformats struct2hdl - debug_jit importdata tetramesh - doc_cache_create iscolormap waterfall - ellipj jit_enable - ellipke jit_startcnt + base64_encode expint prefdir + betaincinv findfigs preferences + built_in_docstrings_file flintmax readline_re_read_init_file + cmpermute fminsearch readline_read_init_file + cmunique gallery rgbplot + colorcube gco save_default_options + copyobj hdl2struct shrinkfaces + dawson history_save splinefit + dblist imformats stemleaf + debug_jit importdata strjoin + doc_cache_create iscolormap struct2hdl + ellipj jit_enable tetramesh + ellipke jit_startcnt waterfall ** Deprecated functions.
--- a/doc/interpreter/gui.txi +++ b/doc/interpreter/gui.txi @@ -81,13 +81,17 @@ @node User-Defined Preferences @section User-Defined Preferences +@DOCSTRING(getpref) + +@DOCSTRING(setpref) + @DOCSTRING(addpref) -@DOCSTRING(getpref) +@DOCSTRING(rmpref) @DOCSTRING(ispref) -@DOCSTRING(rmpref) +@DOCSTRING(prefdir) -@DOCSTRING(setpref) +@DOCSTRING(preferences)
--- a/scripts/help/__unimplemented__.m +++ b/scripts/help/__unimplemented__.m @@ -336,8 +336,6 @@ "plotbrowser", "plotedit", "plottools", - "prefdir", - "preferences", "printdlg", "printopt", "printpreview",
--- a/scripts/prefs/prefdir.m +++ b/scripts/prefs/prefdir.m @@ -17,21 +17,22 @@ ## <http://www.gnu.org/licenses/>. ## -*- texinfo -*- -## @deftypefn {Function File} prefdir -## @deftypefnx {Function File} {folder =} prefdir -## Return the folder that contains the preferences for octave. +## @deftypefn {Function File} {} prefdir +## @deftypefnx {Function File} {@var{dir} =} prefdir +## Return the directory that contains the preferences for Octave. ## ## Examples: ## -## Display the preferences folder +## Display the preferences directory ## @example ## prefdir ## @end example ## ## Change to the preferences folder ## @example -## cd(prefdir) +## cd (prefdir) ## @end example +## @seealso{preferences, getpref, setpref, addpref, rmpref} ## @end deftypefn ## Author: John Donoghue @@ -39,6 +40,7 @@ function folder = prefdir () - folder = getenv("HOME"); - -endfunction \ No newline at end of file + folder = getenv ("HOME"); + +endfunction +
--- a/scripts/prefs/preferences.m +++ b/scripts/prefs/preferences.m @@ -18,14 +18,12 @@ ## -*- texinfo -*- ## @deftypefn {Function File} {} preferences -## Display the preferences settings. If in GUI mode, display using the preferences dialog, otherwise display in EDITOR. +## Display preferences settings for Octave. ## -## Example: -# -## @example -## preferences -## @end example +## If in GUI mode, display using the preferences dialog, otherwise display +## the preferences with the @code{edit} function. ## +## @seealso{getpref, setpref, addpref, rmpref} ## @end deftypefn ## Author: John Donoghue @@ -33,10 +31,9 @@ function preferences () if (! __octave_link_enabled__ ()) - prefs_file = [ getenv("HOME") "/.octave_prefs" ]; - - edit (prefs_file); + edit (prefsfile ()); else - __octave_link_show_preferences__ (); + __octave_link_show_preferences__ (); endif -endfunction \ No newline at end of file +endfunction +
--- a/scripts/prefs/private/prefsfile.m +++ b/scripts/prefs/private/prefsfile.m @@ -25,9 +25,8 @@ function retval = prefsfile () - retval = [ prefdir() "/.octave_prefs" ]; + retval = [prefdir() filesep() ".octave_prefs"]; - endfunction %% Testing these functions will require some care to avoid wiping out