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

[Fred L. Drake]

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

Modified Files:
	doc.tex 
Log Message:

For \kbd, be more prescriptive regarding how keystrokes should be
written.


Index: doc.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/doc/doc.tex,v
retrieving revision 1.44
retrieving revision 1.45
diff -C2 -r1.44 -r1.45
*** doc.tex	2001/07/09 16:04:03	1.44
--- doc.tex	2001/07/12 02:08:29	1.45
***************
*** 788,793 ****
        Mark a sequence of keystrokes.  What form \var{key sequence}
        takes may depend on platform- or application-specific
!       conventions.  For example, an \program{xemacs} key sequence
!       may be marked like \code{\e kbd\{C-x C-f\}}.
      \end{macrodesc}
  
--- 788,798 ----
        Mark a sequence of keystrokes.  What form \var{key sequence}
        takes may depend on platform- or application-specific
!       conventions.  When there are no relevant conventions, the names
!       of modifier keys should be spelled out, to improve accessibility
!       for new users and non-native speakers.  For example, an
!       \program{xemacs} key sequence may be marked like
!       \code{\e kbd\{C-x C-f\}}, but without reference to a specific
!       application or platform, the same sequence should be marked as
!       \code{\e kbd\{Control-x Control-f\}}.
      \end{macrodesc}