mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-08-03 00:23:06 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 6

Add a little bit more about the XML migration plan. This still needs a lot

Browse source 
of work, but mostly it needs time spent doing the work to make the
generated XML useful.
This commit is contained in:
Fred Drake 2001-07-09 16:04:03 +00:00
parent 03e88da81b
commit 67f193faab
1 changed files with 23 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

27
Doc/doc/doc.tex
View file

@ -1062,7 +1062,7 @@ This \UNIX\ is also followed by a space.
be used for an advantage when the documents are processed using
the tools for Python documentation processing. In particular, the
generated HTML looks good! There is also an advantage for the
eventual conversion of the documentation to SGML (see section
eventual conversion of the documentation to XML (see section
\ref{futures}, ``Future Directions'').
Each environment is named \env{table\var{cols}}, where \var{cols}
@ -1585,7 +1585,7 @@ This \UNIX\ is also followed by a space.
SGML offers advantages which may appeal most to authors,
especially those using ordinary text editors. There are also
additional abilities to define content models. A number of
high-quality tools with demonstrated maturity is available, but
high-quality tools with demonstrated maturity are available, but
most are not free; for those which are, portability issues remain
a problem.
@ -1597,9 +1597,28 @@ This \UNIX\ is also followed by a space.
short term. The promised availability of a wide variety of
high-quality tools which support some of the most important
related standards is not immediate. Many tools are likely to be
free.
free, and the portability issues of those which are, are not
expected to be significant.
It turns out that converting to an XML or SGML system holds
promise for translators as well; how much can be done to ease the
burden on translators remains to be seen, and may have some impact
on the schema and specific technologies used.
XXX Eventual migration to XML.
The documentation will be moved to XML in the future, and tools
are being written which will convert the documentation from the
current format to something close to a finished version, to the
extent that the desired information is already present in the
documentation. Some XSLT stylesheets have been started for
presenting a preliminary XML version as HTML, but the results are
fairly rough..
The timeframe for the conversion is not clear since there doesn't
seem to be much time available to work on this, but the appearant
benefits are growing more substantial at a moderately rapid pace.
XXX Eventual migration to SGML/XML.
\subsection{Discussion Forums \label{discussion}}