[Python-checkins] CVS: python/dist/src/Doc/api abstract.tex,1.7,1.8 intro.tex,1.2,1.3

[Fred L. Drake]

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

Modified Files:
	abstract.tex intro.tex 
Log Message:
Clean up some markup cruft.  A number of the macros that take no
parameters (like \UNIX) are commonly entered using an empty group to
separate the markup from a following inter-word space; this is not
needed when the next character is punctuation, or the markup is the
last thing in the enclosing group.  These cases were marked
inconsistently; the empty group is now *only* used when needed.


Index: abstract.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/api/abstract.tex,v
retrieving revision 1.7
retrieving revision 1.8
diff -C2 -d -r1.7 -r1.8
*** abstract.tex	2001/11/12 07:46:31	1.7
--- abstract.tex	2001/11/28 07:26:14	1.8
***************
*** 737,741 ****
  \begin{cfuncdesc}{PyObject*}{PySequence_Fast_GET_ITEM}{PyObject *o, int i}
    Return the \var{i}th element of \var{o}, assuming that \var{o} was
!   returned by \cfunction{PySequence_Fast()}, \var{o} is not \NULL{},
    and that \var{i} is within bounds.
  \end{cfuncdesc}
--- 737,741 ----
  \begin{cfuncdesc}{PyObject*}{PySequence_Fast_GET_ITEM}{PyObject *o, int i}
    Return the \var{i}th element of \var{o}, assuming that \var{o} was
!   returned by \cfunction{PySequence_Fast()}, \var{o} is not \NULL,
    and that \var{i} is within bounds.
  \end{cfuncdesc}
***************
*** 744,748 ****
    Returns the length of \var{o}, assuming that \var{o} was
    returned by \cfunction{PySequence_Fast()} and that \var{o} is
!   not \NULL{}.  The size can also be gotten by calling
    \cfunction{PySequence_Size()} on \var{o}, but
    \cfunction{PySequence_Fast_GET_SIZE()} is faster because it can
--- 744,748 ----
    Returns the length of \var{o}, assuming that \var{o} was
    returned by \cfunction{PySequence_Fast()} and that \var{o} is
!   not \NULL.  The size can also be gotten by calling
    \cfunction{PySequence_Size()} on \var{o}, but
    \cfunction{PySequence_Fast_GET_SIZE()} is faster because it can

Index: intro.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/api/intro.tex,v
retrieving revision 1.2
retrieving revision 1.3
diff -C2 -d -r1.2 -r1.3
*** intro.tex	2001/10/25 15:53:44	1.2
--- intro.tex	2001/11/28 07:26:14	1.3
***************
*** 4,8 ****
  The Application Programmer's Interface to Python gives C and
  \Cpp{} programmers access to the Python interpreter at a variety of
! levels.  The API is equally usable from \Cpp{}, but for brevity it is
  generally referred to as the Python/C API.  There are two
  fundamentally different reasons for using the Python/C API.  The first
--- 4,8 ----
  The Application Programmer's Interface to Python gives C and
  \Cpp{} programmers access to the Python interpreter at a variety of
! levels.  The API is equally usable from \Cpp, but for brevity it is
  generally referred to as the Python/C API.  There are two
  fundamentally different reasons for using the Python/C API.  The first