From c12c11040e25b690cecaa0543a22c7aff8c3797c Mon Sep 17 00:00:00 2001 From: Denis Peplin Date: Thu, 5 Aug 2004 10:04:31 +0000 Subject: Use url entities for links between docs --- .../articles/committers-guide/article.sgml | 20 +-- en_US.ISO8859-1/articles/console-server/Makefile | 2 + .../articles/console-server/article.sgml | 8 +- en_US.ISO8859-1/articles/contributing/article.sgml | 12 +- en_US.ISO8859-1/articles/contributors/article.sgml | 4 +- en_US.ISO8859-1/articles/cvs-freebsd/Makefile | 2 + en_US.ISO8859-1/articles/cvs-freebsd/article.sgml | 4 +- en_US.ISO8859-1/articles/dialup-firewall/Makefile | 2 + .../articles/dialup-firewall/article.sgml | 5 +- en_US.ISO8859-1/articles/euro/Makefile | 2 + en_US.ISO8859-1/articles/euro/article.sgml | 5 +- .../articles/filtering-bridges/Makefile | 2 + .../articles/filtering-bridges/article.sgml | 4 +- en_US.ISO8859-1/articles/fonts/Makefile | 2 + en_US.ISO8859-1/articles/fonts/article.sgml | 4 +- .../articles/freebsd-questions/Makefile | 2 + .../articles/freebsd-questions/article.sgml | 6 +- en_US.ISO8859-1/articles/ipsec-must/Makefile | 2 + en_US.ISO8859-1/articles/ipsec-must/article.sgml | 5 +- en_US.ISO8859-1/articles/java-tomcat/Makefile | 2 + en_US.ISO8859-1/articles/java-tomcat/article.sgml | 6 +- .../articles/mailing-list-faq/article.sgml | 14 +- en_US.ISO8859-1/articles/new-users/Makefile | 2 + en_US.ISO8859-1/articles/new-users/article.sgml | 2 +- en_US.ISO8859-1/articles/pr-guidelines/Makefile | 2 + .../articles/pr-guidelines/article.sgml | 4 +- en_US.ISO8859-1/articles/problem-reports/Makefile | 2 + .../articles/problem-reports/article.sgml | 14 +- en_US.ISO8859-1/articles/releng/Makefile | 2 + en_US.ISO8859-1/articles/releng/article.sgml | 6 +- en_US.ISO8859-1/articles/serial-uart/Makefile | 2 + en_US.ISO8859-1/articles/serial-uart/article.sgml | 4 +- en_US.ISO8859-1/books/arch-handbook/book.sgml | 2 +- .../books/developers-handbook/book.sgml | 2 +- .../developers-handbook/kerneldebug/chapter.sgml | 2 +- .../developers-handbook/policies/chapter.sgml | 10 +- en_US.ISO8859-1/books/faq/book.sgml | 156 ++++++++++----------- .../books/fdp-primer/see-also/chapter.sgml | 2 +- .../books/fdp-primer/sgml-markup/chapter.sgml | 4 +- .../books/fdp-primer/the-website/chapter.sgml | 2 +- .../handbook/advanced-networking/chapter.sgml | 2 +- .../books/handbook/bibliography/chapter.sgml | 4 +- en_US.ISO8859-1/books/handbook/config/chapter.sgml | 2 +- .../books/handbook/install/chapter.sgml | 2 +- .../books/handbook/introduction/chapter.sgml | 8 +- en_US.ISO8859-1/books/handbook/ports/chapter.sgml | 4 +- .../books/handbook/serialcomms/chapter.sgml | 2 +- en_US.ISO8859-1/books/porters-handbook/Makefile | 2 + en_US.ISO8859-1/books/porters-handbook/book.sgml | 21 +-- .../share/sgml/glossary/freebsd-glossary.sgml | 2 +- 50 files changed, 222 insertions(+), 162 deletions(-) diff --git a/en_US.ISO8859-1/articles/committers-guide/article.sgml b/en_US.ISO8859-1/articles/committers-guide/article.sgml index 91af421771..a9fa47258e 100644 --- a/en_US.ISO8859-1/articles/committers-guide/article.sgml +++ b/en_US.ISO8859-1/articles/committers-guide/article.sgml @@ -715,11 +715,11 @@ alias scvs env CVS_RSH=ssh cvs -d user@ncvs.FreeBSD.o You will almost certainly get a conflict because - of the $Id: article.sgml,v 1.203 2004-08-02 04:15:08 murray Exp $ (or in FreeBSD's case, + of the $Id: article.sgml,v 1.204 2004-08-05 10:04:26 den Exp $ (or in FreeBSD's case, $FreeBSD$) lines, so you will have to edit the file to resolve the conflict - (remove the marker lines and the second $Id: article.sgml,v 1.203 2004-08-02 04:15:08 murray Exp $ line, - leaving the original $Id: article.sgml,v 1.203 2004-08-02 04:15:08 murray Exp $ line intact). + (remove the marker lines and the second $Id: article.sgml,v 1.204 2004-08-05 10:04:26 den Exp $ line, + leaving the original $Id: article.sgml,v 1.204 2004-08-05 10:04:26 den Exp $ line intact). @@ -1029,7 +1029,7 @@ checkout -P Add yourself to the Developers section of - the Contributors List + the Contributors List and remove yourself from the Additional Contributors section. @@ -1424,7 +1424,7 @@ docs:Documentation Bug:freebsd-doc: related discussion takes place on the &a.doc;. Committers interested in contributing to the documentation should familiarize themselves with the Documentation Project + url="&url.books.fdp-primer;/index.html">Documentation Project Primer. @@ -1873,7 +1873,7 @@ docs:Documentation Bug:freebsd-doc: Makefile for any package or subtree which is being actively maintained by one or more people; see + url="&url.books.developers-handbook;/policies.html"> for documentation on this. Where sections of code have several maintainers, commits to affected areas by one maintainer need to be reviewed by at least one other @@ -1887,7 +1887,7 @@ docs:Documentation Bug:freebsd-doc: someone who manages an overall category of FreeBSD evolution, such as internationalization or networking. See + url="&url.articles.contributors;/staff-who.html"> http://www.FreeBSD.org/doc/en_US.ISO8859-1/articles/contributors/staff-who.html for more information on this. @@ -2357,7 +2357,7 @@ docs:Documentation Bug:freebsd-doc: The - Porters + Porters Handbook contains more detailed instructions. @@ -2368,7 +2368,7 @@ docs:Documentation Bug:freebsd-doc: If the port came from a submitter who has not contributed to the project before, add that person's name to the Additional + url="&url.articles.contributors;/contrib-additional.html">Additional Contributors section of the FreeBSD Contributors List. @@ -2763,7 +2763,7 @@ docs:Documentation Bug:freebsd-doc: Submit a docs PR to add the new category to both the - + Porter's Handbook and to www/en/ports/categories. diff --git a/en_US.ISO8859-1/articles/console-server/Makefile b/en_US.ISO8859-1/articles/console-server/Makefile index b3384825b1..fcb305cc9c 100644 --- a/en_US.ISO8859-1/articles/console-server/Makefile +++ b/en_US.ISO8859-1/articles/console-server/Makefile @@ -14,5 +14,7 @@ INSTALL_ONLY_COMPRESSED?= SRCS= article.sgml IMAGES_EN= tk0231-9-1.png +URL_RELPREFIX?= ../../../.. DOC_PREFIX?= ${.CURDIR}/../../.. + .include "${DOC_PREFIX}/share/mk/doc.project.mk" diff --git a/en_US.ISO8859-1/articles/console-server/article.sgml b/en_US.ISO8859-1/articles/console-server/article.sgml index 890accf8f4..6787bc7af1 100644 --- a/en_US.ISO8859-1/articles/console-server/article.sgml +++ b/en_US.ISO8859-1/articles/console-server/article.sgml @@ -7,6 +7,8 @@ %authors; %trademark; + +%urls; ]>
@@ -329,7 +331,7 @@ will need to upgrade to a more modern version of &os; (which you should do anyway, to make sure your system is not vulnerable to known security issues). See the &os; + url="&url.books.handbook;/makeworld.html">&os; Handbook for information about updating your system. @@ -342,7 +344,7 @@ GENERIC kernel, so you will need to create a kernel config file with the appropriate entries. See &man.stl.4; and the appropriate section of the &os; + URL="&url.books.handbook;/kernelconfig.html">&os; Handbook. @@ -1276,7 +1278,7 @@ exit 0 Using a Serial Console on &os; The procedure for doing this is described in detail in the - &os; + &os; Handbook. This is a quick summary. diff --git a/en_US.ISO8859-1/articles/contributing/article.sgml b/en_US.ISO8859-1/articles/contributing/article.sgml index 4b2878f2ef..000748a1b7 100644 --- a/en_US.ISO8859-1/articles/contributing/article.sgml +++ b/en_US.ISO8859-1/articles/contributing/article.sgml @@ -106,7 +106,7 @@ FreeBSD Entities//EN"> %freebsd; language, you can help translate additional documents or verify that the translations are up-to-date. First take a look at the Translations + url="&url.books.fdp-primer;/translations.html">Translations FAQ in the FreeBSD Documentation Project Primer. You are not committing yourself to translating every single FreeBSD document by doing this — as a @@ -248,7 +248,7 @@ FreeBSD Entities//EN"> %freebsd; tolerance for a high volume of mail!) may subscribe to the &a.hackers;. See The + url="&url.books.handbook;/eresources.html#ERESOURCES-MAIL">The FreeBSD Handbook for more information about this and other mailing lists. @@ -280,7 +280,7 @@ FreeBSD Entities//EN"> %freebsd; the &a.bugs;. See also this + URL="&url.articles.problem-reports;/article.html">this article on how to write good problem reports. @@ -291,7 +291,7 @@ FreeBSD Entities//EN"> %freebsd; Changes to the documentation are overseen by the &a.doc;. Please look at the FreeBSD Documentation + url="&url.books.fdp-primer;/index.html">FreeBSD Documentation Project Primer for complete instructions. Send submissions and changes (even small ones are welcome!) using &man.send-pr.1; as described in %freebsd; known as FreeBSD-CURRENT which is made available in a variety of ways for the convenience of developers working actively on the system. See The FreeBSD + &url.books.handbook;/current-stable.html">The FreeBSD Handbook for more information about getting and using FreeBSD-CURRENT. @@ -546,7 +546,7 @@ THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. We can always use new mirror sites for FTP, WWW or cvsup. If you would like to be such a mirror, please see the Mirroring FreeBSD + url="&url.articles.hubs;/index.html">Mirroring FreeBSD article for more information. diff --git a/en_US.ISO8859-1/articles/contributors/article.sgml b/en_US.ISO8859-1/articles/contributors/article.sgml index 60fb711019..fef0c1f7d4 100644 --- a/en_US.ISO8859-1/articles/contributors/article.sgml +++ b/en_US.ISO8859-1/articles/contributors/article.sgml @@ -301,7 +301,7 @@ BSDi (formerly Walnut Creek CDROM) has donated almost more than we can say (see the 'About the FreeBSD Project' - section of the FreeBSD Handbook for more details). + section of the FreeBSD Handbook for more details). In particular, we would like to thank them for the original hardware used for freefall.FreeBSD.org, our primary @@ -530,7 +530,7 @@ - Release + Release Coordination diff --git a/en_US.ISO8859-1/articles/cvs-freebsd/Makefile b/en_US.ISO8859-1/articles/cvs-freebsd/Makefile index a450bb703e..1740a1a8e9 100644 --- a/en_US.ISO8859-1/articles/cvs-freebsd/Makefile +++ b/en_US.ISO8859-1/articles/cvs-freebsd/Makefile @@ -13,5 +13,7 @@ INSTALL_ONLY_COMPRESSED?= SRCS= article.sgml +URL_RELPREFIX?= ../../../.. DOC_PREFIX?= ${.CURDIR}/../../.. + .include "${DOC_PREFIX}/share/mk/doc.project.mk" diff --git a/en_US.ISO8859-1/articles/cvs-freebsd/article.sgml b/en_US.ISO8859-1/articles/cvs-freebsd/article.sgml index 2f0ad424fc..014627f14f 100644 --- a/en_US.ISO8859-1/articles/cvs-freebsd/article.sgml +++ b/en_US.ISO8859-1/articles/cvs-freebsd/article.sgml @@ -5,6 +5,8 @@ %authors; %trademarks; + +%urls; ]>
@@ -112,7 +114,7 @@ Now you need to obtain the CVSROOT directory from the FreeBSD repository. This is most easily done by checking it out from a FreeBSD anonymous CVS mirror. See the relevant chapter in + url="&url.books.handbook;/anoncvs.html">the relevant chapter in the handbook for more information. Let us assume that the sources are stored in CVSROOT-freebsd in the current directory. diff --git a/en_US.ISO8859-1/articles/dialup-firewall/Makefile b/en_US.ISO8859-1/articles/dialup-firewall/Makefile index 37854b51ad..c512d68c66 100644 --- a/en_US.ISO8859-1/articles/dialup-firewall/Makefile +++ b/en_US.ISO8859-1/articles/dialup-firewall/Makefile @@ -12,5 +12,7 @@ INSTALL_ONLY_COMPRESSED?= SRCS= article.sgml +URL_RELPREFIX?= ../../../.. DOC_PREFIX?= ${.CURDIR}/../../.. + .include "${DOC_PREFIX}/share/mk/doc.project.mk" diff --git a/en_US.ISO8859-1/articles/dialup-firewall/article.sgml b/en_US.ISO8859-1/articles/dialup-firewall/article.sgml index 6ea1502af6..88fd86c288 100644 --- a/en_US.ISO8859-1/articles/dialup-firewall/article.sgml +++ b/en_US.ISO8859-1/articles/dialup-firewall/article.sgml @@ -11,6 +11,9 @@ %trademarks; + + +%urls; ]>
@@ -64,7 +67,7 @@ In order to use IPFW, support for it must be compiled into the kernel. For more information on how to recompile the kernel, please see the kernel configuration + URL="&url.books.handbook;/kernelconfig.html">kernel configuration section in the Handbook. The following options must be added into your kernel configuration file for IPFW support: diff --git a/en_US.ISO8859-1/articles/euro/Makefile b/en_US.ISO8859-1/articles/euro/Makefile index 6efcc67d29..e1247939d0 100644 --- a/en_US.ISO8859-1/articles/euro/Makefile +++ b/en_US.ISO8859-1/articles/euro/Makefile @@ -12,5 +12,7 @@ INSTALL_ONLY_COMPRESSED?= SRCS= article.sgml +URL_RELPREFIX?= ../../../.. DOC_PREFIX?= ${.CURDIR}/../../.. + .include "${DOC_PREFIX}/share/mk/doc.project.mk" diff --git a/en_US.ISO8859-1/articles/euro/article.sgml b/en_US.ISO8859-1/articles/euro/article.sgml index f0906e4801..3d7cb36628 100644 --- a/en_US.ISO8859-1/articles/euro/article.sgml +++ b/en_US.ISO8859-1/articles/euro/article.sgml @@ -4,6 +4,9 @@ %trademarks; + + +%urls; ]>
@@ -59,7 +62,7 @@ The Euro in a nutshell If you already feel comfortable with - localization as + localization as described in the FreeBSD Handbook you might be only interested in the following facts which will get you started quickly: diff --git a/en_US.ISO8859-1/articles/filtering-bridges/Makefile b/en_US.ISO8859-1/articles/filtering-bridges/Makefile index 6b6c1b3fae..d9e00e9285 100644 --- a/en_US.ISO8859-1/articles/filtering-bridges/Makefile +++ b/en_US.ISO8859-1/articles/filtering-bridges/Makefile @@ -12,5 +12,7 @@ INSTALL_ONLY_COMPRESSED?= SRCS= article.sgml +URL_RELPREFIX?= ../../../.. DOC_PREFIX?= ${.CURDIR}/../../.. + .include "${DOC_PREFIX}/share/mk/doc.project.mk" diff --git a/en_US.ISO8859-1/articles/filtering-bridges/article.sgml b/en_US.ISO8859-1/articles/filtering-bridges/article.sgml index 306ac1bbe3..99c31812d2 100644 --- a/en_US.ISO8859-1/articles/filtering-bridges/article.sgml +++ b/en_US.ISO8859-1/articles/filtering-bridges/article.sgml @@ -5,6 +5,8 @@ %freebsd; %trademarks; + +%urls; ]>
@@ -109,7 +111,7 @@ options IPFIREWALL_VERBOSE Now it is necessary to build and install the new kernel. You may find detailed instructions in the Building + url="&url.books.handbook;/kernelconfig-building.html">Building and Installing a Custom Kernel section of the FreeBSD Handbook. diff --git a/en_US.ISO8859-1/articles/fonts/Makefile b/en_US.ISO8859-1/articles/fonts/Makefile index d1da66dfde..0163a287fa 100644 --- a/en_US.ISO8859-1/articles/fonts/Makefile +++ b/en_US.ISO8859-1/articles/fonts/Makefile @@ -12,5 +12,7 @@ INSTALL_ONLY_COMPRESSED?= SRCS= article.sgml +URL_RELPREFIX?= ../../../.. DOC_PREFIX?= ${.CURDIR}/../../.. + .include "${DOC_PREFIX}/share/mk/doc.project.mk" diff --git a/en_US.ISO8859-1/articles/fonts/article.sgml b/en_US.ISO8859-1/articles/fonts/article.sgml index ec361445f0..b988270d3a 100644 --- a/en_US.ISO8859-1/articles/fonts/article.sgml +++ b/en_US.ISO8859-1/articles/fonts/article.sgml @@ -7,6 +7,8 @@ %man; %trademarks; + +%urls; ]> :-) @@ -2844,7 +2845,7 @@ PATCHFILES= patch1:test into your pkg-descr. For a detailed description of the responsibilities of maintainers, - refer to the MAINTAINER on + refer to the MAINTAINER on Makefiles section. If the maintainer of a port does not respond to an update @@ -4775,7 +4776,7 @@ MASTERDIR= ${.CURDIR}/../xdvi300 Shared library versions - Please read our policy on + Please read our policy on shared library versioning to understand what to do with shared library versions in general. Do not blindly assume software authors know what they are doing; many of them do not. It is very @@ -5336,7 +5337,7 @@ IGNORE=POINTYHAT is not supported ports, you will probably find it easier to use CVSup to keep your whole ports collection up-to-date, as described in the - Handbook. + Handbook. This will have the added benefit of tracking all the ports' dependencies. @@ -5395,7 +5396,7 @@ IGNORE=POINTYHAT is not supported and this is an area where more volunteers are always needed. (For a detailed description of the responsibilities of maintainers, refer to the - + MAINTAINER on Makefiles section.) The best way to @@ -5413,7 +5414,7 @@ IGNORE=POINTYHAT is not supported as is. Before you &man.send-pr.1;, you should review the - + Writing the problem report section in the Problem Reports article; it contains far more information about how to write useful problem reports. @@ -5965,7 +5966,7 @@ Reference: <http://www.freebsd.org/ports/portaudit/74a9541d-5d6c-11d8-80e3-00 the porting process. You should check your own port against this list, but you can also check ports in the PR database that others have submitted. Submit any comments on ports you check as described in - Bug Reports and General + Bug Reports and General Commentary. Checking ports in the PR database will both make it faster for us to commit them, and prove that you know what you are doing. @@ -6036,7 +6037,7 @@ Reference: <http://www.freebsd.org/ports/portaudit/74a9541d-5d6c-11d8-80e3-00 Do not write anything to files outside WRKDIR. WRKDIR is the only place that is guaranteed to be writable during the port build (see - + installing ports from a CDROM for an example of building ports from a read-only tree). If you need to modify one of the pkg-* diff --git a/en_US.ISO8859-1/share/sgml/glossary/freebsd-glossary.sgml b/en_US.ISO8859-1/share/sgml/glossary/freebsd-glossary.sgml index 13dd1914b5..989640e58d 100644 --- a/en_US.ISO8859-1/share/sgml/glossary/freebsd-glossary.sgml +++ b/en_US.ISO8859-1/share/sgml/glossary/freebsd-glossary.sgml @@ -32,7 +32,7 @@ A phenomenon whereby many people will give an opinion on an uncomplicated topic, whilst a complex topic receives little or no discussion. See the - FAQ for + FAQ for the origin of the term. -- cgit v1.2.3