[latexrefman-commits] r401 - in /trunk: ChangeLog latex2e.texi

[jhefferon at domain.hid]

Author: jhefferon
Date: Fri Aug 14 13:51:42 2015
New Revision: 401

URL: http://svn.gna.org/viewcvs/latexrefman?rev=401&view=rev
Log:
create nodes for Environment and for Declaration

Modified:
    trunk/ChangeLog
    trunk/latex2e.texi

Modified: trunk/ChangeLog
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/ChangeLog?rev=401&r1=400&r2=401&view=diff
==============================================================================
--- trunk/ChangeLog	(original)
+++ trunk/ChangeLog	Fri Aug 14 13:51:42 2015
@@ -1,3 +1,9 @@
+2015-08-14  Jim Hefferon  <jhefferon at domain.hid>
+
+	* latex2e.texi (Environment, Declaration): Create these two nodes
+	subordinate to LaTeX command syntax.  Refer node item to LaTeX
+	command syntax.
+
 2015-08-13  Jim Hefferon  <jhefferon at domain.hid>
 
 	* latex2e.texi (item): Add node for this command, subordinate to

Modified: trunk/latex2e.texi
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/latex2e.texi?rev=401&r1=400&r2=401&view=diff
==============================================================================
--- trunk/latex2e.texi	(original)
+++ trunk/latex2e.texi	Fri Aug 14 13:51:42 2015
@@ -428,23 +428,82 @@
 character, @code{\}.  The name itself then consists of either
 (a)@tie{}a string of letters or (b)@tie{}a single non-letter.
 
-A command may be followed by zero, one, or more arguments, either
-required or optional.  Required arguments are contained in curly
-braces, @code{@{...@}}.  Optional arguments are contained in square
-brackets, @code{[...]}.  Generally, but not universally, if the
-command accepts an optional argument, it comes first, before any
-required arguments.
-
-Some commands have a @code{*} form that is related to the form without
-a @code{*}, such as @code{\chapter} and @code{\chapter*}.
-
- at domain.hid{} commands are case sensitive; neither @code{\Begin at domain.hid@}}
-nor @code{\begin at domain.hid@}} will work.  Most commands are lowercase,
-but in any event you must enter all commands in the same case as they
-are defined.
+ at LaTeX{} commands are case sensitive so that @code{\pagebreak} differs
+from @code{\Pagebreak} (the latter is not a standard command).  Most
+commands are lowercase, but in any event you must enter all commands in
+the same case as they are defined.
+
+A command may be followed by zero, one, or more arguments. These
+arguments may be either required or optional.  Required arguments are
+contained in curly braces, @code{@{...@}}.  Optional arguments are
+contained in square brackets, @code{[...]}.  Generally, but not
+universally, if the command accepts an optional argument, it comes
+first, before any required arguments.
+
+Inside of an optional argument, to use the character close square
+bracket at domain.hid{]}) hide it inside curly braces, as
+in at domain.hid bracket @{]@}]}.  Similarly, if an optional
+argument comes last, with no required argument after it, then to make
+the first character of the following text be an open square bracket,
+hide it inside curly braces.
+
+ at LaTeX{} has the convention that some commands have a @code{*} form that
+is related to the form without a @code{*}, such as @code{\chapter} and
+ at code{\chapter*}.  The exact difference in behavior varies from command
+to command.
 
 This manual describes all accepted options and @code{*}-forms for the
 commands it covers (barring unintentional omissions, a.k.a.@: bugs).
+
+ at menu
+* Environment::          Area of the source with distinct behavior.
+* Declaration::          Change the value or meaning of a command.
+ at end menu
+
+
+ at node Environment
+
+Synopsis:
+
+ at example
+\begin at domain.hid name}@}
+  ..
+\end at domain.hid name}@}
+ at end example
+
+An area of @LaTeX{} source, inside of which there is a distinct
+behavior.  For instance, for poetry in @LaTeX{} put the lines between
+ at code{\begin at domain.hid@}} and @code{\end at domain.hid@}}.
+
+ at example
+\begin at domain.hid@}
+    There once was a man from Nantucket \\
+     ..
+\end at domain.hid@}
+ at end example
+
+The @var{environment name} at the beginning must exactly match that at
+the end.  This includes the case where @var{environment name} ends in a
+star at domain.hid{*}); both the @code{\begin} and @code{\end} texts must
+include the star.
+
+Environments may have arguments, including optional arguments.  This
+example produces a table.  The first argument is optional (and causes
+the table to be aligned on its top row) while the second argument is
+required (it specifies the formatting of columns).
+
+ at example
+\begin at domain.hid@}
+  .. rows of table ..
+\end at domain.hid@}
+ at end example 
+
+
+ at node Declaration
+
+A command that changes the value, or changes the meaning, of some other
+command or parameter.  For instance, the @code{\mainmatter} command
+changes the setting of page numbers from roman numerals to arabic.
 
 
 @node Document classes
@@ -2700,7 +2759,7 @@
 inside the optional argument you must hide them inside curly braces, as
 in @code{\item[Close square bracket, @{]@}]}.  Similarly, to use an open
 square bracket as first character in the text of the item, also hide it
-inside curly braces.
+inside curly braces.  @xref{@LaTeX{} command syntax}.
 
 In this example the @code{enumerate} list has two items that use the
 default label and one that uses the optional label.