the10thwiz/cc65
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

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

Browse Source 
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
Download Patch File Download Diff File Expand all files Collapse all files

11
doc/funcref.sgml
View File

@@ -3,7 +3,7 @@
<article>
<title>cc65 function reference
<author><url url="mailto:uz@cc65.org" name="Ullrich von Bassewitz">
<date>07.11.2002
<date>2014-04-10
<abstract>
cc65 is a C compiler for 6502 based systems. This function reference describes
@@ -23,7 +23,7 @@ just some of the supported machines. This function refrence describes the
available functions together with any limitations.
For an overview about the available libraries, their purpose, and any
differences to the ISO standard, please have a look at the <htmlurl
differences to the ISO standard, please have a look at the <url
url="library.html" name="cc65 Library Overview">.
<bf/Note:/ Standard C functions are listed here, but not described in detail.
@@ -276,8 +276,7 @@ function.
<sect1><tt/dio.h/<label id="dio.h"><p>
<htmlurl url="dio.html" name="dio.html">
Low-level disk I/O API.
<url url="dio.html" name="Low-level disk I/O API">.
<sect1><tt/dirent.h/<label id="dirent.h"><p>
@@ -416,8 +415,8 @@ Low-level disk I/O API.
<sect1><tt/o65.h/<label id="o65.h"><p>
The <tt/o65.h/ header file contains structure and constant definitions that
may be used when dealing with files in <htmlurl
url="http://www.6502.org/users/andre/o65/fileformat.html" name="o65 format">.
may be used when dealing with files in <url
url="http://www.6502.org/users/andre/o65/fileformat.html" name="the o65 format">.
It does not declare any functions.