database/postgres
1
0
Fork 0
mirror of https://github.com/postgres/postgres.git synced 2025-07-30 11:03:19 +03:00
Code Activity

Add guidelines section.

Browse Source
This commit is contained in:
Bruce Momjian
2009-01-10 16:03:15 +00:00
parent 908e2c7fd1
commit feba07f838
1 changed files with 12 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

13
doc/src/sgml/README.links
View File

@ -1,10 +1,11 @@
<!-- $PostgreSQL: pgsql/doc/src/sgml/README.links,v 1.1 2009/01/10 04:40:08 momjian Exp $ --> <!-- $PostgreSQL: pgsql/doc/src/sgml/README.links,v 1.2 2009/01/10 16:03:15 momjian Exp $ -->
Linking within SGML documents can be confusing, so here is a summary: Linking within SGML documents can be confusing, so here is a summary:
Intra-document Linking Intra-document Linking
---------------------- ----------------------
<xref> <xref>
used to link to a section without supplying text for the link; used to link to a section without supplying text for the link;
text comes from the link target; has no close tag text comes from the link target; has no close tag
@ -23,8 +24,10 @@ endterm=
link target; endterm in a <link> overrides the supplied text link target; endterm in a <link> overrides the supplied text
External Linking External Linking
---------------- ----------------
<ulink> <ulink>
like <link>, but uses a URL (not a document target); requires like <link>, but uses a URL (not a document target); requires
</ulink>; if no text is specified, the URL appears as the link text </ulink>; if no text is specified, the URL appears as the link text
@ -32,3 +35,11 @@ External Linking
url= url=
used by <ulink> to specify the URL used by <ulink> to specify the URL
Guidelines
----------
o Do not use endterm with <link> because the supplied text is ignored; use
<xref>
o Do not use text with <ulink> so the URL appears in printed output