broke long line in error message

[pspp-builds.git] / doc / utilities.texi

diff --git a/doc/utilities.texi b/doc/utilities.texi
index 009706e22584dc8591508992813cd6d4ff08cd9d..03ef7c342b709a274ba2299e7f5cb131dd57faae 100644 (file)
--- a/doc/utilities.texi
+++ b/doc/utilities.texi
@@ -1,4 +1,4 @@
-@node Utilities, Not Implemented, Statistics, Top
+@node Utilities

 @chapter Utilities
 
 Commands that don't fit any other category are placed here.
 @chapter Utilities
 
 Commands that don't fit any other category are placed here.


@@ -10,6 +10,7 @@ encountered in the input.
 
 @menu
 * ADD DOCUMENT::                Add documentary text to the active file.
 
 @menu
 * ADD DOCUMENT::                Add documentary text to the active file.

+* CD::                          Change the current directory.

 * COMMENT::                     Document your syntax file.
 * DOCUMENT::                    Document the active file.
 * DISPLAY DOCUMENTS::           Display active file documents.
 * COMMENT::                     Document your syntax file.
 * DOCUMENT::                    Document the active file.
 * DISPLAY DOCUMENTS::           Display active file documents.


@@ -29,7 +30,7 @@ encountered in the input.
 * TITLE::                       Provide a document title.
 @end menu
 
 * TITLE::                       Provide a document title.
 @end menu
 

-@node ADD DOCUMENT, COMMENT, Utilities, Utilities
+@node ADD DOCUMENT

 @comment  node-name,  next,  previous,  up
 @section ADD DOCUMENT
 @vindex  ADD DOCUMENT
 @comment  node-name,  next,  previous,  up
 @section ADD DOCUMENT
 @vindex  ADD DOCUMENT


@@ -49,9 +50,19 @@ DOCUMENTS}.
 Each line of documentary text must be enclosed in quotation marks, and 
 may not be more than 80 bytes long. @xref{DOCUMENT}.
 
 Each line of documentary text must be enclosed in quotation marks, and 
 may not be more than 80 bytes long. @xref{DOCUMENT}.
 

+@node CD
+@section CD
+@vindex CD
+@cindex directory
+@cindex changing directory

 
 

+@display
+CD 'new directory' .
+@end display 
+
+@cmd{CD} changes the current directory.  The new directory will become that specified by the command.

 
 

-@node COMMENT, DOCUMENT, ADD DOCUMENT, Utilities
+@node COMMENT

 @section COMMENT
 @vindex COMMENT
 @vindex *
 @section COMMENT
 @vindex COMMENT
 @vindex *


@@ -70,7 +81,7 @@ terminate it with a dot or a blank line.
 
 
 
 
 
 

-@node DOCUMENT, DISPLAY DOCUMENTS, COMMENT, Utilities
+@node DOCUMENT

 @section DOCUMENT
 @vindex DOCUMENT
 
 @section DOCUMENT
 @vindex DOCUMENT
 


@@ -91,7 +102,7 @@ You can extend the documentary text over as many lines as necessary.
 Lines are truncated at 80 bytes.  Don't forget to terminate
 the command with a dot or a blank line. @xref{ADD DOCUMENT}.
 
 Lines are truncated at 80 bytes.  Don't forget to terminate
 the command with a dot or a blank line. @xref{ADD DOCUMENT}.
 

-@node DISPLAY DOCUMENTS, DISPLAY FILE LABEL, DOCUMENT, Utilities
+@node DISPLAY DOCUMENTS

 @section DISPLAY DOCUMENTS
 @vindex DISPLAY DOCUMENTS
 
 @section DISPLAY DOCUMENTS
 @vindex DISPLAY DOCUMENTS
 


@@ -103,7 +114,7 @@ DISPLAY DOCUMENTS.
 document is preceded by a line giving the time and date that it was
 added.  @xref{DOCUMENT}.
 
 document is preceded by a line giving the time and date that it was
 added.  @xref{DOCUMENT}.
 

-@node DISPLAY FILE LABEL, DROP DOCUMENTS, DISPLAY DOCUMENTS, Utilities
+@node DISPLAY FILE LABEL

 @section DISPLAY FILE LABEL
 @vindex DISPLAY FILE LABEL
 
 @section DISPLAY FILE LABEL
 @vindex DISPLAY FILE LABEL
 


@@ -117,7 +128,7 @@ if any.  @xref{FILE LABEL}.
 
 This command is a PSPP extension.
 
 
 This command is a PSPP extension.
 

-@node DROP DOCUMENTS, ECHO, DISPLAY FILE LABEL, Utilities
+@node DROP DOCUMENTS

 @section DROP DOCUMENTS
 @vindex DROP DOCUMENTS
 
 @section DROP DOCUMENTS
 @vindex DROP DOCUMENTS
 


@@ -131,7 +142,7 @@ New documents can be added with @cmd{DOCUMENT} (@pxref{DOCUMENT}).
 @cmd{DROP DOCUMENTS} changes only the active file.  It does not modify any
 system files stored on disk.
 
 @cmd{DROP DOCUMENTS} changes only the active file.  It does not modify any
 system files stored on disk.
 

-@node ECHO, ERASE, DROP DOCUMENTS, Utilities
+@node ECHO

 @section ECHO
 @vindex ECHO
 
 @section ECHO
 @vindex ECHO
 


@@ -141,7 +152,7 @@ ECHO 'arbitrary text' .
 
 Use @cmd{ECHO} to write arbitrary text to the output stream. The text should be enclosed in quotation marks following the normal rules for string tokens (@pxref{Tokens}).
 
 
 Use @cmd{ECHO} to write arbitrary text to the output stream. The text should be enclosed in quotation marks following the normal rules for string tokens (@pxref{Tokens}).
 

-@node ERASE, EXECUTE, ECHO, Utilities
+@node ERASE

 @comment  node-name,  next,  previous,  up
 @section ERASE
 @vindex ERASE
 @comment  node-name,  next,  previous,  up
 @section ERASE
 @vindex ERASE


@@ -155,7 +166,7 @@ file_name must be quoted.
 This command cannot be used if the SAFER setting is active.
 
 
 This command cannot be used if the SAFER setting is active.
 
 

-@node EXECUTE, FILE LABEL, ERASE, Utilities
+@node EXECUTE

 @section EXECUTE
 @vindex EXECUTE
 
 @section EXECUTE
 @vindex EXECUTE
 


@@ -166,7 +177,7 @@ EXECUTE.
 @cmd{EXECUTE} causes the active file to be read and all pending
 transformations to be executed.
 
 @cmd{EXECUTE} causes the active file to be read and all pending
 transformations to be executed.
 

-@node FILE LABEL, FINISH, EXECUTE, Utilities
+@node FILE LABEL

 @section FILE LABEL
 @vindex FILE LABEL
 
 @section FILE LABEL
 @vindex FILE LABEL
 


@@ -181,7 +192,7 @@ created during this PSPP run.
 file_label need not be quoted.  If quotes are
 included, they become part of the file label.
 
 file_label need not be quoted.  If quotes are
 included, they become part of the file label.
 

-@node FINISH, HOST, FILE LABEL, Utilities
+@node FINISH

 @section FINISH
 @vindex FINISH
 
 @section FINISH
 @vindex FINISH
 


@@ -192,7 +203,7 @@ FINISH.
 @cmd{FINISH} terminates the current PSPP session and returns
 control to the operating system.
 
 @cmd{FINISH} terminates the current PSPP session and returns
 control to the operating system.
 

-@node HOST, INCLUDE, FINISH, Utilities
+@node HOST

 @comment  node-name,  next,  previous,  up
 @section HOST
 @vindex HOST
 @comment  node-name,  next,  previous,  up
 @section HOST
 @vindex HOST


@@ -206,7 +217,7 @@ to the operating system.
 This command cannot be used if the SAFER setting is active.
 
 
 This command cannot be used if the SAFER setting is active.
 
 

-@node INCLUDE, PERMISSIONS, HOST, Utilities
+@node INCLUDE

 @section INCLUDE
 @vindex INCLUDE
 @vindex @@
 @section INCLUDE
 @vindex INCLUDE
 @vindex @@


@@ -224,7 +235,7 @@ command file.
 Include files may be nested to any depth, up to the limit of available
 memory.
 
 Include files may be nested to any depth, up to the limit of available
 memory.
 

-@node PERMISSIONS, SET, INCLUDE, Utilities
+@node PERMISSIONS

 @comment  node-name,  next,  previous,  up
 @section PERMISSIONS
 @vindex PERMISSIONS
 @comment  node-name,  next,  previous,  up
 @section PERMISSIONS
 @vindex PERMISSIONS


@@ -249,7 +260,7 @@ unchanged.
 This command cannot be used if the SAFER setting is active.
 
 
 This command cannot be used if the SAFER setting is active.
 
 

-@node SET, SHOW, PERMISSIONS, Utilities
+@node SET

 @section SET
 @vindex SET
 
 @section SET
 @vindex SET
 


@@ -621,7 +632,7 @@ When set, this setting cannot be reset during the same session, for
 obvious security reasons.
 @end table
 
 obvious security reasons.
 @end table
 

-@node SHOW, SUBTITLE, SET, Utilities
+@node SHOW

 @comment  node-name,  next,  previous,  up
 @section SHOW
 @vindex SHOW
 @comment  node-name,  next,  previous,  up
 @section SHOW
 @vindex SHOW


@@ -670,7 +681,7 @@ Display the terms of PSPP's copyright licence (@pxref{License}).
 
 Specifying @cmd{SHOW} without any subcommands is equivalent to SHOW ALL.
 
 
 Specifying @cmd{SHOW} without any subcommands is equivalent to SHOW ALL.
 

-@node SUBTITLE, TITLE, SHOW, Utilities
+@node SUBTITLE

 @section SUBTITLE
 @vindex SUBTITLE
 
 @section SUBTITLE
 @vindex SUBTITLE
 


@@ -688,7 +699,7 @@ Specify a subtitle as a string in quotes.  The alternate syntax that did
 not require quotes is now obsolete.  If it is used then the subtitle is
 converted to all uppercase.
 
 not require quotes is now obsolete.  If it is used then the subtitle is
 converted to all uppercase.
 

-@node TITLE,  , SUBTITLE, Utilities
+@node TITLE

 @section TITLE
 @vindex TITLE
 
 @section TITLE
 @vindex TITLE