[Python-checkins] CVS: python/dist/src/Doc/doc doc.tex,1.15,1.16

Mon, 3 Apr 2000 00:47:19 -0400

Update of /projects/cvsroot/python/dist/src/Doc/doc
In directory seahag.cnri.reston.va.us:/home/fdrake/projects/python/Doc/doc
Modified Files:
	doc.tex 
Log Message:
Merged changes from the 1.5.2p2 release.
Index: doc.tex
===================================================================
RCS file: /projects/cvsroot/python/dist/src/Doc/doc/doc.tex,v
retrieving revision 1.15
retrieving revision 1.16
diff -C2 -r1.15 -r1.16
*** doc.tex	1999年11月10日 22:51:18	1.15
--- doc.tex	2000年04月03日 04:47:16	1.16
***************
*** 227,230 ****
--- 227,243 ----
 facilities.

+ \subsection{Meta-information Markup \label{meta-info}}
+ 
+ \begin{macrodesc}{sectionauthor}{\p{author}\p{email}}
+ Identifies the author of the current section. \var{author}
+ should be the author's name such that it can be used for
+ presentation (though it isn't), and \var{email} should be the
+ author's email address. The domain name portion of
+ the address should be lower case.
+ 
+ No presentation is generated from this markup, but it is used to 
+ help keep track of contributions.
+ \end{macrodesc}
+ 
 \subsection{Information Units \label{info-units}}

***************
*** 413,417 ****
 \begin{macrodesc}{email}{\p{address}}
 An email address. Note that this is \emph{not} hyperlinked in
! any of the possible output formats.
 \end{macrodesc}

--- 426,431 ----
 \begin{macrodesc}{email}{\p{address}}
 An email address. Note that this is \emph{not} hyperlinked in
! any of the possible output formats. The domain name portion of
! the address should be lower case.
 \end{macrodesc}

***************
*** 690,695 ****
 table generated by this environment contains two columns, and each
 row is defined by an alternate definition of
! \macro{modulesynopsis}. This environment is not normally use by
! the user, but is created by the \macro{localmoduletable} macro.

--- 704,709 ----
 table generated by this environment contains two columns, and each
 row is defined by an alternate definition of
! \macro{modulesynopsis}. This environment is not normally used by
! authors, but is created by the \macro{localmoduletable} macro.

***************
*** 727,731 ****

 Effective index generation for technical documents can be very
! difficult, especially for someone familliar with the topic but not
 the creation of indexes. Much of the difficulty arises in the
 area of terminology: including the terms an expert would use for a
--- 741,745 ----

 Effective index generation for technical documents can be very
! difficult, especially for someone familiar with the topic but not
 the creation of indexes. Much of the difficulty arises in the
 area of terminology: including the terms an expert would use for a
***************
*** 736,740 ****
 The truly difficult aspects of index generation are not areas with
 which the documentation tools can help. However, ease
! of producing the index once content decisions are make is within
 the scope of the tools. Markup is provided which the processing
 software is able to use to generate a variety of kinds of index
--- 750,754 ----
 The truly difficult aspects of index generation are not areas with
 which the documentation tools can help. However, ease
! of producing the index once content decisions are made is within
 the scope of the tools. Markup is provided which the processing
 software is able to use to generate a variety of kinds of index