Ticket #1288 (closed defect: fixed)
[with patch] misformating of some of the reference manual in live version; also out of date
| Reported by: | was | Owned by: | mhansen |
|---|---|---|---|
| Priority: | major | Milestone: | sage-2.9 |
| Component: | documentation | Keywords: | |
| Cc: | Work issues: | ||
| Report Upstream: | Reviewers: | ||
| Authors: | Merged in: | ||
| Dependencies: | Stopgaps: |
Description
See below. I suspect that the best solution is to remove this stuff about "sage -advanced" from the reference manual entirely, since it is always going to get out of date, hence be misleading. It's much better to just described how "sage -advanced" works, and suggest that the user try it out, then improve the output of "sage -advanced".
Reading 2.3 of the Reference Manual from the Notebook interface, I find that this "live" version has turned the lines:
\item
\verb+-advanced+ Lists additional options:
\begin{verbatim}
$ sage -advanced
in devel/doc-main/ref/options.tex into
<li><code>-advanced</code> Lists additional options:
<p>
<div class="verbatim"><pre><span class="math"> sage -advanced
in localhost:8000/doc/live/ref/node7.html , which, of course, completely wrecks the formatting. There seems to be no problem with the pre-built devel/doc-main/html/ref/node7.html , where latex2html has correctly turned the TeX into
<LI><code>-advanced</code> Lists additional options:
<P>
<div class="verbatim"><pre>
$ sage -advanced
Moreover, the list of options given in options.tex is considerably different from those currently produced by sage -advanced .
Mac OS X 10.4.11
Sage 2.8.14
--
Francis Clarke
Attachments
Change History
comment:1 Changed 5 years ago by mhansen
- Owner changed from tba to mhansen
- Status changed from new to assigned
comment:2 Changed 5 years ago by mhansen
- Summary changed from misformating of some of the reference manual in live version; also out of date to [with patch] misformating of some of the reference manual in live version; also out of date
- Milestone changed from sage-2.10 to sage-2.9
Note: See
TracTickets for help on using
tickets.

