Fixed the SGML <htmlurl> and <url> tags.

Those tags have two attributes: "url=" and "name=".  In the non-HTML output formats, <url> shows both fields, while <htmlurl> shows only the name field (as the HTML format always does.)  Thus, the general rules are
1. If the two attributes are different, then use <url>.
2. If they are similar, then use <htmlurl>.
3. If they are the same, then consider using <url> without the "name=" attribute.
(The reason for rules 2 and 3 is that the same text shouldn't be shown twice.)

There can be exceptions.  Example: "od65.sgml" has <htmlurl> because the URL
would disturb the flow of a sentence.
This commit is contained in:
Greg King
2014-04-14 05:54:13 -04:00
parent 4e14a9dbb9
commit bb9aa7558f
21 changed files with 101 additions and 112 deletions

View File

@@ -3,7 +3,7 @@
<article>
<title>Diskette Sector I/O Routines
<author><url url="mailto:chris@groessler.org" name="Christian Groessler">
<date>20-Feb-2005
<date>2014-04-10
<abstract>
The cc65 library provides functions to read and write raw disk sectors.
@@ -89,8 +89,8 @@ The following function returns the sector size of the currently inserted disk:
</verb></tscreen>
On the Atari platform, the sector size is handled specially. Please refer
to the DIO section in the <htmlurl url="atari.html" name="Atari">
specific platform documentation.
to the DIO section in the <url url="atari.html" name="Atari-specific
platform documentation">.
<p>
The following function returns the sector count of the currently inserted disk: