| README (91732) | README (158627) |
|---|---|
| 1-*- text -*- 2RELNOTESng README 3Bruce A. Mah <bmah@freebsd.org> | 1-*- text -*- 2RELNOTESng README 3Bruce A. Mah <bmah@freebsd.org> |
| 4$FreeBSD: head/release/doc/README 91732 2002-03-06 07:59:18Z bmah $ | 4$FreeBSD: head/release/doc/README 158627 2006-05-15 21:10:34Z wilko $ |
| 5 6This is the top-level directory for RELNOTESng, a re-write of 7FreeBSD's *.TXT documentation files. They have been converted to 8DocBook, and versions of the documents can be now be built for various 9supported architectures. The output files can be rendered in any 10format supported by the FreeBSD Documentation Project (for example, 11ASCII text, PDF, PS, HTML). 12 --- 21 unchanged lines hidden (view full) --- 34 locate the "real" stylesheet by reference, rather than having 35 to specify it by pathname. 36share/sgml/release.dsl 37 Language-neutral stylesheet. This stylesheet supports 38 the arch= attribute on (all?) DocBook elements; elements with 39 an arch= attribute are only included in the output if their 40 value is equal to the value of the &arch; entity. In the 41 future, arch= could be a list of possible &arch; entity values | 5 6This is the top-level directory for RELNOTESng, a re-write of 7FreeBSD's *.TXT documentation files. They have been converted to 8DocBook, and versions of the documents can be now be built for various 9supported architectures. The output files can be rendered in any 10format supported by the FreeBSD Documentation Project (for example, 11ASCII text, PDF, PS, HTML). 12 --- 21 unchanged lines hidden (view full) --- 34 locate the "real" stylesheet by reference, rather than having 35 to specify it by pathname. 36share/sgml/release.dsl 37 Language-neutral stylesheet. This stylesheet supports 38 the arch= attribute on (all?) DocBook elements; elements with 39 an arch= attribute are only included in the output if their 40 value is equal to the value of the &arch; entity. In the 41 future, arch= could be a list of possible &arch; entity values |
| 42 that match, such as "i386,alpha". | 42 that match, such as "i386,sparc64". |
| 43share/sgml/release.ent 44 Release information. Need to update the entry definitions in 45 this file when rolling new revisions; these should take effect 46 in all documents. 47 48en_US.ISO8859-1/share/sgml/release.dsl 49 Language-dependent stylesheet for en, but also the default for 50 translations if they don't override the settings here. This --- 41 unchanged lines hidden (view full) --- 92contents of this file carefully when doing version number bumps. 93 94When creating content for the architecture-dependent files, authors 95should use the arch= attribute to elements that are specific to a 96particular machine architecture. The value of this attribute should 97be a single word that indicates for which architecture the current 98element will be included. For example: 99 | 43share/sgml/release.ent 44 Release information. Need to update the entry definitions in 45 this file when rolling new revisions; these should take effect 46 in all documents. 47 48en_US.ISO8859-1/share/sgml/release.dsl 49 Language-dependent stylesheet for en, but also the default for 50 translations if they don't override the settings here. This --- 41 unchanged lines hidden (view full) --- 92contents of this file carefully when doing version number bumps. 93 94When creating content for the architecture-dependent files, authors 95should use the arch= attribute to elements that are specific to a 96particular machine architecture. The value of this attribute should 97be a single word that indicates for which architecture the current 98element will be included. For example: 99 |
| 100 <para arch="alpha">Alpha-specific text</para> | 100 <para arch="sparc64">SPARC64-specific text</para> |
| 101 | 101 |
| 102The currently-supported architectures are i386, alpha, sparc64, and | 102The currently-supported architectures are i386, sparc64, and |
| 103ia64. An element may appear for multiple architectures by specifying | 103ia64. An element may appear for multiple architectures by specifying |
| 104a comma-separated list of architectures (i.e. arch="alpha,ia64"). | 104a comma-separated list of architectures (i.e. arch="sparc64,ia64"). |
| 105 106When creating a translation, make a new directory under this 107directory with a language code (paralleling the DocProj directory 108structure). If necessary, new language-dependent HTML footers can be 109generated by making a new language-dependent 110${LANG}/share/sgml/release.dsl, a ${LANG}/share/sgml/catalog that 111points to it, and a new definition in the Makefiles that adds 112${LANG}/share/sgml/catalog to EXTRA_CATALOGS. Except for the Makefile --- 14 unchanged lines hidden --- | 105 106When creating a translation, make a new directory under this 107directory with a language code (paralleling the DocProj directory 108structure). If necessary, new language-dependent HTML footers can be 109generated by making a new language-dependent 110${LANG}/share/sgml/release.dsl, a ${LANG}/share/sgml/catalog that 111points to it, and a new definition in the Makefiles that adds 112${LANG}/share/sgml/catalog to EXTRA_CATALOGS. Except for the Makefile --- 14 unchanged lines hidden --- |