| Commit message (Collapse) | Author | Age | Files | Lines |
| |
|
|
|
| |
Notes:
svn path=/head/; revision=4144
svn path=/release/LINUXDOC_2_DOCBOOK_3/; revision=4145; tag=LINUXDOC_2_DOCBOOK_3
|
| |
|
|
|
|
|
|
|
|
|
| |
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
|
| |
|
|
|
|
|
| |
Minor whitespace change within a <screen>.
Notes:
svn path=/head/; revision=4138
|
| |
|
|
|
|
|
| |
of the table, to work around a JadeTeX bug.
Notes:
svn path=/head/; revision=4137
|
| |
|
|
|
|
|
|
| |
PR: docs/9687
Submitted by: Mark Ovens <marco@uk.radan.com>
Notes:
svn path=/head/; revision=4122
|
| |
|
|
|
|
|
|
| |
doc/en/handbook/ is still not ready for prime time. Please no commits
in here. Thanks.
Notes:
svn path=/head/; revision=4120
|
| |
|
|
|
|
|
| |
is expected, so prefix them with "-" so make(1) ignores it.
Notes:
svn path=/head/; revision=4111
|
| |
|
|
|
|
|
|
|
|
| |
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
|
| |
|
|
|
|
|
|
|
|
|
| |
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
|
| |
|
|
|
|
|
|
|
|
| |
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
|
| |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
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
|
| |
|
|
|
|
|
| |
Submitted by: "Sameer R. Manek" <manek@ecst.csuchico.edu>
Notes:
svn path=/head/; revision=3925
|
| |
|
|
|
|
|
| |
Submitted by: "Sameer R. Manek" <manek@ecst.csuchico.edu>
Notes:
svn path=/head/; revision=3924
|
| |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
* 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
|
| |
|
|
|
|
|
| |
Text, PS, PDF)
Notes:
svn path=/head/; revision=3905
|
| |
|
|
|
|
|
|
| |
PR: docs/8820
Submitted by: Ming-I Hsieh <PA@FreeBSD.ee.ntu.edu.tw>
Notes:
svn path=/head/; revision=3856
|
| |
|
|
|
|
|
|
| |
possibly wasting a page).
Submitted by: Stephen Montgomery-Smith <stephen@showme.missouri.edu>
Notes:
svn path=/head/; revision=3812
|
| |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
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
|
| |
|
|
|
|
|
| |
build the HTML and RTF formats.
Notes:
svn path=/head/; revision=3792
|
| |
|
|
| |
Notes:
svn path=/head/; revision=3764
|
| |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
- 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
|
| |
|
|
|
|
|
|
|
|
|
|
|
| |
<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
|
| |
|
|
|
|
|
|
| |
I blame the keyboard pixies for putting it in there when I wasn't
looking.
Notes:
svn path=/head/; revision=3749
|
| |
|
|
|
|
|
| |
added to the bottom.
Notes:
svn path=/head/; revision=3742
|
| |
|
|
| |
Notes:
svn path=/head/; revision=3741
|
| |
|
|
| |
Notes:
svn path=/head/; revision=3736
|
| |
|
|
|
|
|
| |
r1.83 of doc/handbook/handbook.sgml
Notes:
svn path=/head/; revision=3735
|
| |
|
|
|
|
|
| |
as to authors.ent, and add an ENTITY line to handbook.sgml.
Notes:
svn path=/head/; revision=3734
|
| |
|
|
|
|
|
| |
freebsd.dtd.
Notes:
svn path=/head/; revision=3733
|
| |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
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
|
| |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
<!--
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
<!--
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
|
| |
|
|
|
|
|
|
|
|
|
|
| |
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
|
| |
|
|
| |
Notes:
svn path=/head/; revision=3727
|
| |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
* Fixup use of <symbol> with more appropriate element
* Fixup wrong occurence of $Id$
* Fixup references to 'make' variables, and strim off the surrounding
${...}, 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> -> “
Notes:
svn path=/head/; revision=3685
|
| |
|
|
|
|
|
| |
in <literal>...</literal>.
Notes:
svn path=/head/; revision=3684
|
| |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
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
|
| |
|
|
| |
Notes:
svn path=/head/; revision=3682
|
| |
|
|
| |
Notes:
svn path=/head/; revision=3681
|
| |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
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><\([^&]+\)></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
|
| |
|
|
|
|
|
|
|
|
|
|
| |
kicking around here,
daughter-in-law, X-rated = hyphen = -
pages 13--67 = en-dash = –
yes---or no? = em-dash = —
0, 1, and -1 = minus sign = −
Notes:
svn path=/head/; revision=3679
|
| |
|
|
|
|
|
|
|
|
| |
replaces
\s-+</title> -> </title>
<title>\s-+ -> <title>
Notes:
svn path=/head/; revision=3678
|
| |
|
|
|
|
|
|
|
|
|
|
| |
<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
|
| |
|
|
| |
Notes:
svn path=/head/; revision=3676
|
| |
|
|
| |
Notes:
svn path=/head/; revision=3659
|
| |
|
|
| |
Notes:
svn path=/head/; revision=3658
|
| |
|
|
| |
Notes:
svn path=/head/; revision=3657
|
| |
|
|
| |
Notes:
svn path=/head/; revision=3656
|
| |
|
|
| |
Notes:
svn path=/head/; revision=3652
|