[Python-checkins] python/dist/src/Doc/doc doc.tex,1.68,1.69

[fdrake@users.sourceforge.net]

Update of /cvsroot/python/python/dist/src/Doc/doc
In directory usw-pr-cvs1:/tmp/cvs-serv21222

Modified Files:
	doc.tex 
Log Message:
Finish & commit some docs for markup that's been in use for a while.


Index: doc.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/doc/doc.tex,v
retrieving revision 1.68
retrieving revision 1.69
diff -C2 -d -r1.68 -r1.69
*** doc.tex	14 Aug 2002 16:40:54 -0000	1.68
--- doc.tex	25 Sep 2002 18:44:21 -0000	1.69
***************
*** 1642,1649 ****
  
  
! \section{Graphical Interface Components \label{gui-markup}}
  
    The components of graphical interfaces will be assigned markup, but
!   the specifics have not been determined.
  
  
--- 1642,1676 ----
  
  
! \subsection{Graphical Interface Components \label{gui-markup}}
  
    The components of graphical interfaces will be assigned markup, but
!   most of the specifics have not been determined.
! 
!   \begin{macrodesc}{menuselection}{\p{menupath}}
!     Menu selections should be marked using a combination of
!     \macro{menuselection} and \macro{sub}.  This macro is used to mark
!     a complete sequence of menu selections, including selecting
!     submenus and choosing a specific operation, or any subsequence of
!     such a sequence.  The names of individual selections should be
!     separated by occurances of \macro{sub}.
! 
!     For example, to mark the selection ``\menuselection{Start \sub
!     Programs}'', use this markup:
! 
! \begin{verbatim}
! \menuselection{Start \sub Programs}
! \end{verbatim}
! 
!     When including a selection that includes some trailing indicator,
!     such as the ellipsis some operating systems use to indicate that
!     the command opens a dialog, the indicator should be omitted from
!     the selection name.
!   \end{macrodesc}
! 
!   \begin{macrodesc}{sub}{}
!     Separator for menu selections that include multiple levels.  This
!     macro is only defined within the context of the
!     \macro{menuselection} macro.
!   \end{macrodesc}