aboutsummaryrefslogtreecommitdiff
path: root/en
Commit message (Collapse)AuthorAgeFilesLines
* Create tag 'LINUXDOC_2_DOCBOOK_3'.LINUXDOC_2_DOCBOOK_3Doc Manager1999-01-2860-52170/+0
| | | | | Notes: svn path=/head/; revision=4144 svn path=/release/LINUXDOC_2_DOCBOOK_3/; revision=4145; tag=LINUXDOC_2_DOCBOOK_3
* Add "-V html-manifest" to index.html target rules, so that it's onlyNik Clayton1999-01-271-6/+6
| | | | | | | | | | | generated for this target, and not the generic .html target as well. Additional "-" before TeX and PDFTeX calls, which also return non-zero status codes (almost called them errorlevels, how long since I last wrote a .bat file?) Notes: svn path=/head/; revision=4139
* Add frame="none" attribute to two <informaltable>s.Nik Clayton1999-01-271-3/+3
| | | | | | | Minor whitespace change within a <screen>. Notes: svn path=/head/; revision=4138
* Pull a footnote out of an <informaltable> and into a <note> at the endNik Clayton1999-01-271-17/+18
| | | | | | | of the table, to work around a JadeTeX bug. Notes: svn path=/head/; revision=4137
* Added a link to Mark Ovens' FreeBSD NTFS tutorial.Nik Clayton1999-01-271-2/+4
| | | | | | | | PR: docs/9687 Submitted by: Mark Ovens <marco@uk.radan.com> Notes: svn path=/head/; revision=4122
* Add missing </para> from previous commit by dwhite.Nik Clayton1999-01-271-1/+1
| | | | | | | | doc/en/handbook/ is still not ready for prime time. Please no commits in here. Thanks. Notes: svn path=/head/; revision=4120
* Currently the first two calls to tex return a non-zero status code. ThisNik Clayton1999-01-251-3/+3
| | | | | | | is expected, so prefix them with "-" so make(1) ignores it. Notes: svn path=/head/; revision=4111
* Move doc/sgml/* to doc/share/sgml/*, so it better follows the layout ofNik Clayton1999-01-251-4/+4
| | | | | | | | | | Doc. Proj. related ports under $PREFIX/share. Update en/handbook/Makefile with the new paths. Didn't seem worthwhile to do a repository copy for only three files moved. Notes: svn path=/head/; revision=4110
* The JadeTeX macros appear to have problems dealing with footnotes in tables.Nik Clayton1999-01-202-16/+19
| | | | | | | | | | | Rather than delay any longer for a fix from Sebastien Rahtz (my TeX is not up to fixing it, natch) replace footnotes in tables with <note>...</note> after the table. When the JadeTeX macros DTRT, this change can be reverted. Notes: svn path=/head/; revision=4089
* Extra support in the Makefile. Now builds html, html-split, rtf, ps, and pdfNik Clayton1999-01-031-26/+211
| | | | | | | | | | versions (modulo bugs in JadeTex). "make install" and "make clean" now also seem to do the right thing. Extensive documentation included, comments welcomed. Notes: svn path=/head/; revision=4017
* Added output.html and output.print as parameter entities to freebsd.dtd.Nik Clayton1998-12-201-7/+5
| | | | | | | | | | | | | | | | | | | | | | | | | | Default to "IGNORE", you should set them to "INCLUDE" by whatever mechanism your SGML parser supports as necessary (i.e., Jade's -i flag). Added redefinitions for some ISO entities that aren't understood by most web browsers. Since this is for HTML output only, wrap it in a %output.html; marked section. Use these marked sections to put both print and HTML stylesheets in one .dsl file (freebsd.dsl). The print stylesheet now understands about the elements that have been added to DocBook (and won't try and render them in red). Updated Makefile to use output.html and output.print on the command line to Jade, instead of the earlier "html" and "print. Note: producing .tex (and thence .ps and .pdf) versions of the Handbook is broken. The Handbook tickles several bugs in the JadeTeX macros. Sebastian Rahz, the JadeTeX author, knows about this, and is working on fixing them. Notes: svn path=/head/; revision=3950
* Add entry for the 3Com xl driver.Doug White1998-12-151-0/+7
| | | | | | | Submitted by: "Sameer R. Manek" <manek@ecst.csuchico.edu> Notes: svn path=/head/; revision=3925
* Update maximum number of pty's from 64 to 256.Doug White1998-12-151-1/+1
| | | | | | | Submitted by: "Sameer R. Manek" <manek@ecst.csuchico.edu> Notes: svn path=/head/; revision=3924
* * Added boothelp.sgmlNik Clayton1998-12-1030-2928/+3931
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * Merged in changes between tags LINUXDOC_2_DOCBOOK and LINUXDOC_2_DOCBOOK_2. The merges are as follows (if a file isn't listed here it's because there are no changes to merge since the LINUXDOC_2_DOCBOOK tag was put down). File From -> To Merged to files... --------------------------------------------------------------- authors.sgml 1.118 -> 1.128 authors.ent boothelp.sgml Added contrib.sgml 1.312 -> 1.329 staff/chapter.sgml eresources.sgml 1.50 -> 1.51 eresources/chapter.sgml handbook.sgml 1.91 -> 1.95 handbook.sgml mirrors.sgml 1.92 -> 1.99 mirrors/chapter.sgml porting.sgml 1.112 -> 1.118 [1] ports.sgml 1.31 -> 1.33 ports/chapter.sgml printing.sgml 1.22 -> 1.23 printing/chapter.sgml stable.sgml 1.17 -> 1.18 cutting-edge/chapter.sgml [2] submitters.sgml 1.246 -> 1.261 contrib/chapter.sgml [1] Merged changes. Part of these changes are the migration of the "Making a port" section from contrib/chapter.sgml to ports/chapter.sgml [2] Merged some changes. 1.18 demotes some of the section headings so that the -stable section will appear on one HTML page. This is not the case with the DocBook stylesheets we're using, so wasn't necessary. For the time being, the -stable headings will follow the -current headings. This can be revisited after the migration is complete. There will be one more merge pass once the Handbook in doc/handbook/ is frozen, and then a pass to reformat (refill) most of the lines in the Handbook so it's more aesthetically pleasing. The SGML parsers don't care, but it makes it easier to follow the structure when editing the documents. * Removed sgml-shorttag: nil sgml-minimize-attributes: max from the Emacs local variables at the bottom of each file. It didn't do quite what I was expecting. Notes: svn path=/head/; revision=3906
* Support making multiple output formats from the Handbook (RTF, HTML,Nik Clayton1998-12-101-11/+61
| | | | | | | Text, PS, PDF) Notes: svn path=/head/; revision=3905
* 64 cylinders -> 64 sectors/trackBill Fumerola1998-11-301-2/+2
| | | | | | | | PR: docs/8820 Submitted by: Ming-I Hsieh <PA@FreeBSD.ee.ntu.edu.tw> Notes: svn path=/head/; revision=3856
* Amend HP text filter to use HP eject page command instead of formfeed (andDoug White1998-11-181-1/+1
| | | | | | | | possibly wasting a page). Submitted by: Stephen Montgomery-Smith <stephen@showme.missouri.edu> Notes: svn path=/head/; revision=3812
* Merged in the following changes. This was done by taking diffs between theNik Clayton1998-11-1224-1564/+2976
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | tags LINUXDOC_2_DOCBOOK_START and LINUXDOC_2_DOCBOOK from doc/handbook/. Note that the LINUXDOC_2_DOCBOOK tag is not necessarily at the HEAD of the file. So some files won't show changes because changes were applied after I laid down the LINUXDOC_2_DOCBOOK tag. Not everything was merged. In some cases, URLs had been shortened; http://www.freebsd.org/docproj/ becomes ../docproj/ This is a mistake, since users browsing the Handbook on their own machine can't be expected to have links like this work. Of course, for mirrors, they'll end up pointing back to the main site. For the mean time, do nothing -- this will need an entity defined to reference the base URL of the FreeBSD site, individual mirrors can set this as necessary. Notice how some files (on the left) are merged to the same file (on the right). This is because the new Handbook file structure is organised on DocBook chapter lines. Files with no revision number in the "From" column didn't exist when I started the conversion. File From -> To Merged to files... --------------------------------------------------------------- anoncvs.sgml -> 1.1 cutting-edge/chapter.sgml authors.sgml 1.93 -> 1.118 authors.ent backups.sgml -> 1.4 backups/chapter.sgml bibliography.sgml 1.33 -> 1.37 bibliography/chapter.sgml contrib.sgml 1.274 -> 1.312 staff/chapter.sgml ctm.sgml 1.22 -> 1.23 cutting-edge/chapter.sgml cvsup.sgml 1.36 -> 1.40 cutting-edge/chapter.sgml disks.sgml -> 1.3 disks/chapter.sgml eresources.sgml 1.39 -> 1.50 eresources/chapter.sgml firewalls.sgml 1.19 -> 1.20 security/chapter.sgml handbook.sgml 1.83 -> 1.91 handbook.sgml history.sgml 1.24 -> 1.25 introduction/chapter.sgml install.sgml 1.65 -> 1.67 install/chapter.sgml isdn.sgml 1.12 -> 1.15 advanced-networking/chapter.sgml kerberos.sgml 1.12 -> 1.13 security/chapter.sgml kernelconfig.sgml 1.31 -> 1.32 kernelconfig/chapter.sgml kerneldebug.sgml 1.17 -> 1.19 kerneldebug/chapter.sgml linuxemu.sgml 1.22 -> 1.24 linuxemu/chapter.sgml memoryuse.sgml 1.11 -> 1.12 internals/chapter.sgml mirrors.sgml 1.80 -> 1.92 mirrors/chapter.sgml nutshell.sgml 1.14 -> 1.15 introduction/chapter.sgml pgpkeys.sgml 1.25 -> 1.28 pgpkeys/chapter.sgml policies.sgml 1.16 -> 1.18 policies/chapter.sgml porting.sgml 1.93 -> 1.112 contrib/chapter.sgml ports.sgml 1.29 -> 1.31 ports/chapter.sgml printing.sgml 1.21 -> 1.22 printing/chapter.sgml relnotes.sgml 1.24 -> 1.28 introduction/chapter.sgml [1] submitters.sgml 1.161 -> 1.246 contrib/chapter.sgml synching.sgml 1.12 -> 1.13 cutting-edge/chapter.sgml userppp.sgml 1.28 -> 1.30 ppp-and-slip/chapter.sgml [1] A chunk of relnotes.sgml is in an IGNORED marked section. Why? Submitted by: A bunch (~ 50%) of merging done by Charles A. Wimmer (cawimm@FreeBSD.ORG), rest by Nik. Notes: svn path=/head/; revision=3793
* The beginnings of a friendlier Makefile. Doesn't do much except let youNik Clayton1998-11-121-59/+105
| | | | | | | build the HTML and RTF formats. Notes: svn path=/head/; revision=3792
* Add myself to the list of developers (in doc/handbook and doc/en/handbook).Archie Cobbs1998-11-092-1/+7
| | | | Notes: svn path=/head/; revision=3764
* Fixed up front matter on the Handbook;Nik Clayton1998-11-071-27/+32
| | | | | | | | | | | | | | | | | - Remove the <bookbiblio> element, it's not needed - Added a <copyright> element and sub-elements. Based on the CVS logs the Handbook dates back to 1995. - Changed the <xref> to a <link> in the abstract. - Reformatted abstract to be neater (sorry translators, but it's only one paragraph). This lets the stylesheets generate a nice front page. Notes: svn path=/head/; revision=3758
* ReplaceNik Clayton1998-11-0519-519/+450
| | | | | | | | | | | | | <xref linkend="target" remap="foo"> with <link linkend="target">foo</link> Internal links within the Handbook now do the right thing. Notes: svn path=/head/; revision=3751
* Removed "sgml-declaration" line from Emacs variables.Nik Clayton1998-11-051-1/+0
| | | | | | | | I blame the keyboard pixies for putting it in there when I wasn't looking. Notes: svn path=/head/; revision=3749
* Managed to miss adding this file somehow. It's had the Emacs local variablesNik Clayton1998-11-041-0/+1062
| | | | | | | added to the bottom. Notes: svn path=/head/; revision=3742
* Added missing "/chapter" to advanced-networking entity definition.Nik Clayton1998-11-041-2/+2
| | | | Notes: svn path=/head/; revision=3741
* Fix line 125 of kerneldebug/chapter.sgml, & -> &amp;Nik Clayton1998-11-032-1/+3
| | | | Notes: svn path=/head/; revision=3736
* Add <!ENTITY rel.current CDATA "2.2.6"> to handbook.sgml, fromNik Clayton1998-11-032-0/+6
| | | | | | | r1.83 of doc/handbook/handbook.sgml Notes: svn path=/head/; revision=3735
* Take version 1.8 of doc/handbook/lists.sgml, apply the same search/replaceNik Clayton1998-11-033-0/+53
| | | | | | | as to authors.ent, and add an ENTITY line to handbook.sgml. Notes: svn path=/head/; revision=3734
* Removed the prompt.* entities from handbook.sgml and added them toNik Clayton1998-11-032-2/+2
| | | | | | | freebsd.dtd. Notes: svn path=/head/; revision=3733
* Added authors.ent. This is v1.93 of doc/handbook/authors.sgml, withNik Clayton1998-11-033-0/+296
| | | | | | | | | | | | | | | | | | | | | these changes; 1. Remove '<tt>' and '</tt>'. 2. Search/replace \s-+<htmlurl url='mailto:\([^']+\)'\s-+name='[^']+'> with <email>\1</email> (there's a leading space before <email>) Added an ENTITY line to handbook.sgml to use the new entities. Notes: svn path=/head/; revision=3732
* AddedNik Clayton1998-11-032-0/+13
| | | | | | | | | | | | | | | | | | <!-- Local Variables: mode: sgml sgml-indent-data: t sgml-omittag: nil sgml-shorttag: nil sgml-always-quote-attributes: t sgml-minimize-attributes: max End: --> to handbook.sgml Notes: svn path=/head/; revision=3731
* Added chapter.decl, which contains a declaration for a DocBook chapter.Nik Clayton1998-11-0328-23/+412
| | | | | | | | | | | | | | | | | | | | | | | Added <!-- Local Variables: mode: sgml sgml-declaration: "../chapter.decl" sgml-indent-data: t sgml-omittag: nil sgml-shorttag: nil sgml-always-quote-attributes: t sgml-minimize-attributes: max sgml-parent-document: ("../handbook.sgml" "part" "chapter") End: --> to the bottom of each chapter.sgml file so that Emacs can do the right thing. Notes: svn path=/head/; revision=3730
* Split the handbook into individual files. Each chapter is in a file calledNik Clayton1998-11-0329-39145/+38169
| | | | | | | | | | | | chapter.sgml in a directory named according to the value the id attribute on that chapter. Added chapters.ent, which lists the entities for each chapter. Updated handbook.sgml to use these entities. Notes: svn path=/head/; revision=3728
* Added values to the 'id' attribute for <chapter>s which don't have them.Nik Clayton1998-11-032-8/+11
| | | | Notes: svn path=/head/; revision=3727
* * \s-+</programlisting> replaced with </programlisting> globally.Nik Clayton1998-10-282-889/+691
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * Fixup use of <symbol> with more appropriate element * Fixup wrong occurence of $Id$ * Fixup references to 'make' variables, and strim off the surrounding &#36;{...}, it can be added back by the stylesheet at presentation time. * More insertions or deletions of <para>...</para> as appropriate. And with this commit, ladies and gentlemen, we're almost there as far as the DocBook conversion goes. I still need to: - Split the big handbook.sgml into its constituent files and directories. - Sort out the files that will contain entities, and put in the correct SGML to use them. - Merge in the changes that have happened to doc/handbook over the past 7 or so months. - Build the Makefile framework and supporting apps to do .txt, .ps, .rtf and .pdf conversions. But the mind numbingly tedious stuff is over. Of course, there's always more to do (like the whole bibliography section should be marked up as a bibliography) and I'm putting together the "This is how the handbook should be marked up" document as well. Oh, and organising my notes on how the Handbook could be re-arranged. But apart from that, it's done :-) Notes: svn path=/head/; revision=3698
* <quote> -> &rdquo;Nik Clayton1998-10-262-345/+349
| | | | | | | </quote> -> &ldquo; Notes: svn path=/head/; revision=3685
* Where kernel options ("options INET" for example) are listed, wrap themNik Clayton1998-10-262-147/+150
| | | | | | | in <literal>...</literal>. Notes: svn path=/head/; revision=3684
* <fooNik Clayton1998-10-262-519/+275
| | | | | | | | | | | | | | | | | | | id="bar"> ... changed to <foo id="bar"> ... Before people complain that "Hang on, now you can't find out what the allocated ID values are with a simple 'grep'" I'll say that's not a problem. I plan to introduce a target in the Makefile (probably something like 'handbook.id' which will automatically generate this list doing a proper SGML parse. Notes: svn path=/head/; revision=3683
* Fixup erroneous or extraneous <para>...</para> elements.Nik Clayton1998-10-262-85/+82
| | | | Notes: svn path=/head/; revision=3682
* <abbrev> -> <acronym> in some cases.Nik Clayton1998-10-262-27/+29
| | | | Notes: svn path=/head/; revision=3681
* Step 1. Find <ulink url="mailto:...">...</ulink> and change the <ulink>Nik Clayton1998-10-262-869/+503
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | to <email>. Can't do this globally. Some of the links are odd (i.e,. the link is not their e-mail address but is their name, eg <ulink url="mailto:nik@freebsd.org">Nik Clayton</ulink> which would turn to <email>Nik Clayton</email> which isn't very useful. Ignore these ones, and do the others. (i.e., the ones that look like <ulink url="mailto:nik@freebsd.org">nik@freebsd.org</ulink> ) This Emacs regexp does the job. Search for: <ulink\s-+url="mailto[^>]+>\([^<]+\)</ulink> Replace with: <email>\1</email> Step 2. A lot of the <email>...</email> sets will have '<' and '>' embedded in them (as entities). These can be removed, since the stylesheet will add them; Search for: <email>&lt;\([^&]+\)&gt;</email> Replace with: <email>\1</email> Step 3. The trick now is to turn <ulink url="mailto:nik@freebsd.org">Nik Clayton</ulink> into Nik Clayton <email>nik@freebsd.org</email> This step could (possibly) have been done first, and then steps 1 and 2 could be done globally. I haven't done this because of concerns about the ordering of names within languages. This transformation is fairly simple in English, I've no idea what it's like in Japanese. Search for: <ulink\s-+url="mailto:\([^"]+\)">\([^<]+\)</ulink> Replace with: \2 <email>\1</email> Step 4. Remove leading and trailing spaces that may have slipped in Search for: <email>\s-+ Replace with: <email> Search for: \s-+</email> Replace with: </email> Notes: svn path=/head/; revision=3680
* Use the correct ISO entities for dashes. According to a TeX manual I haveNik Clayton1998-10-262-90/+99
| | | | | | | | | | | | kicking around here, daughter-in-law, X-rated = hyphen = - pages 13--67 = en-dash = &ndash; yes---or no? = em-dash = &mdash; 0, 1, and -1 = minus sign = &minus; Notes: svn path=/head/; revision=3679
* Removed white space after <title> and before </title>. Use two search andNik Clayton1998-10-262-130/+87
| | | | | | | | | | replaces \s-+</title> -> </title> <title>\s-+ -> <title> Notes: svn path=/head/; revision=3678
* <emphasis remap=..> -> <emphasis>Nik Clayton1998-10-262-817/+833
| | | | | | | | | | | | <literal remap=..> -> <literal> <command remap=..> -> <command> Or deleted <emphasis ..> altogether in some cases. More redundant <para>..</para>'s removed. Notes: svn path=/head/; revision=3677
* As previous commits, to end of file.Nik Clayton1998-10-262-226/+233
| | | | Notes: svn path=/head/; revision=3676
* As previous commit, to line 35973.Nik Clayton1998-10-222-259/+314
| | | | Notes: svn path=/head/; revision=3659
* As earlier commits, to line 30118Nik Clayton1998-10-222-339/+367
| | | | Notes: svn path=/head/; revision=3658
* Small changes to keep it validating.Nik Clayton1998-10-222-9/+6
| | | | Notes: svn path=/head/; revision=3657
* As previous commit, to line 24997Nik Clayton1998-10-222-583/+668
| | | | Notes: svn path=/head/; revision=3656
* As previous commit, to line 20370.Nik Clayton1998-10-212-300/+315
| | | | Notes: svn path=/head/; revision=3652