LDP
/
LDP
mirror of https://github.com/tLDP/LDP
0
1
Fork 0
Code Releases Activity
6,925 Commits 1 Branch 0 Tags 167 MiB
Commit Graph

3500 Commits

Author SHA1 Message Date
Martin A. Brown 5385b26417 Merge pull request #54 from martin-a-brown/master 
switch to svg in Traffic-Control-HOWTO; make a few retired docs buildable (for archive)
 2016-03-30 08:40:11 -07:00
Martin A. Brown e592f58e18 Merge branch 'master' of https://github.com/tgeek77/LDP 2016-03-30 08:29:52 -07:00
Jason S. Evans 18b0b9596f new version of adoc and xml. 2016-03-30 08:18:49 +00:00
Martin A. Brown f8cf8c3dc8 switch to svg for inclusion in PDF 2016-03-29 12:09:13 -07:00
Martin A. Brown 0b944a3485 switch to svg for inclusion in PDF 2016-03-29 12:08:55 -07:00
Martin A. Brown 20444ba81b correcting id="" to xml:id="" 2016-03-29 11:43:10 -07:00
Martin A. Brown 1104c5b83a add an id="revhistory" to each <revhistory/> 2016-03-29 10:58:09 -07:00
Martin A. Brown 6734819ac4 add/correct IDs to <article/> 2016-03-29 10:06:54 -07:00
Martin A. Brown d1694d79a8 add/correct IDs to <article/> 2016-03-29 09:58:21 -07:00
Martin A. Brown a8856c42ae add IDs to <article/> 2016-03-29 09:56:05 -07:00
Martin A. Brown d366b5e397 ad IDs to <footnote/> and <article/> 2016-03-29 09:55:37 -07:00
Martin A. Brown 17f7749536 Merge branch 'master' of github.com:tLDP/LDP 2016-03-22 05:51:48 -07:00
Martin A. Brown 443b01ea3b accepted Linux-Android-HOWTO 2016-03-22 05:45:14 -07:00
Jason S. Evans 223722eac7 added updated adoc and xml files 2016-03-21 10:37:53 +00:00
Jason S. Evans 7c72983cf0 merge 2016-03-16 16:35:49 +01:00
Martin A. Brown fde4259300 select .eps for print output; suppress warnings on linkends with "_" in target 2016-03-15 12:19:47 -07:00
Martin A. Brown 05636454d6 .eps image set suitable for print publication 2016-03-15 12:19:13 -07:00
Martin A. Brown c7e81953c1 correcting date format 2016-03-13 09:51:12 -07:00
Martin A. Brown 1d20accc45 standardizing on lowercase <!doctype linuxdoc system 2016-03-07 09:09:08 -08:00
Martin A. Brown 4e80dff075 add xml:id on the <personname/> element itself 2016-03-03 23:43:40 -08:00
Martin A. Brown ff1010d670 converting to DocBook-5.0 document 
added a DocBook 5.0 declaration and, after failing validation with jing,
changed the anchor location to be inside the <firstname/> element.
Validates now!

(and restoring commit 78ec6080e6 which
suppresses the dbhtml PI for document naming)
 2016-03-03 22:41:22 -08:00
Martin A. Brown 54b266ce3a restore original DocBook 5.0 document 
Assembly-HOWTO.xml was written as a DocBook 5.0 document, however it sported a
declaration of a DocBook XML 4.5 document.  This confused me and I changed all
of the <xlink:href/> elements to <ulink/> elements.

reverts commit 13943cb7fb
 2016-03-03 22:38:26 -08:00
Martin A. Brown 309ddc47af argh, so many misnamed entries for this HOWTO 2016-03-03 13:56:40 -08:00
Jason S. Evans 05d234b9b5 Merge https://github.com/tldp/ldp 2016-03-03 11:01:19 +01:00
Martin A. Brown 1584fa274d relocated to Partitions-Mass-Storage-Definitions-Naming-HOWTO 2016-03-02 22:58:20 -08:00
Martin A. Brown 845066608f relocated to Partitions-Mass-Storage-Definitions-Naming-HOWTO 2016-03-02 22:57:54 -08:00
Martin A. Brown acb829ac51 relocated from Partition-Mass-Storage-Dummies-Linux-HOWTO 2016-03-02 22:57:05 -08:00
Martin A. Brown 19f1f470b8 xmllint replacements for non-validating <code/> 2016-03-02 22:43:22 -08:00
Martin A. Brown 5fd35bc8fe <section/> must have a <title/> and at least one <para/> 2016-03-02 22:29:34 -08:00
Martin A. Brown 1fbab772af <ulink/> element requires url= attribute (not href) 2016-03-02 22:25:27 -08:00
Martin A. Brown 041f1c0ca1 attribute must be moreinfo="none" in <literal/> 2016-03-02 22:24:58 -08:00
Martin A. Brown bafc803492 <progralistingco/> can/should be omitted unless <areaspec/> included 2016-03-02 22:18:00 -08:00
Martin A. Brown 9f848afc2d <note/> must have a <para/> child 2016-03-02 22:16:11 -08:00
Martin A. Brown 49d4a9f7eb xmllint hinted corrections in <articleinfo/> 
DocBook 4.x appears to be fairly picky about order in <author/> elements and
the document will not validate without the order being correct.  Fixed.

Also, in the <revhistory/>, there were plenty of places where multiple
<revremark/> elements needed to be wrapped in a <revdescription/> along with a
bunch of <remark/> elements instead.
 2016-03-02 22:13:53 -08:00
Martin A. Brown def4de4bc5 No label attribute on DocBook 4.5 <graphic/> 
Removed the label= attribute on the <graphic/> element removed any further
validation issues with the TimePrecision-HOWTO
 2016-03-02 21:59:00 -08:00
Martin A. Brown 152e353520 xmllint hinted validation improvements 
first, this is not XSL and in DocBook 4.x, these extra namespaces confuse the
processing toolchain (may be different in DocBook 5.x); next, xmllint refuses
to validate the document because of the order of elements in, for example the
<author/> elements and the <affiliation/> elements; just flipping these in
most cases did the trick
 2016-03-02 21:50:31 -08:00
Martin A. Brown 40922c6836 xmllint hinted at problems: <para/> in <listitem/> 
added a bunch of corrections for <itemizedlist/> <listitem/> and <para/>
nesting to match the DocBook content model more strictly; this allows full
validation of the document
 2016-03-02 21:43:13 -08:00
Martin A. Brown d163edda14 xmllint validations; <revdescription/> and ID fix 
<revremark/> can only have text, but <revdescription/> can contain lots of
other stuff; and a space is invalid in an id= attribute.
 2016-03-02 21:28:27 -08:00
Martin A. Brown 45f1b72757 <programlistingco/> is only used with areaspec 
the external general entities (files) which were getting pulled in already
contained a <programlisting/> element; this XML element was not necessary, but
the lack of an <areaspec/> inside the <programlistingco/> was giving xmllint
fits.
 2016-03-02 21:20:26 -08:00
Martin A. Brown 029b9fef03 xmllint suggested validation corrections 
apparently, DocBook is quite picky about the order of children elements within
the <affiliation/> element; so rearranged; and also only one of <revremark/>
or <revdescription/> is (technically) allowed in a <revision/>, so I chose to
convert the <revremark/> elements to <remark/> and drop them inside of a
<revdescription/>, which allows much richer expression of content
 2016-03-02 21:18:36 -08:00
Martin A. Brown b74ebb0b21 minor validation fixes (xmllint) 2016-03-02 21:04:29 -08:00
Martin A. Brown 0ffb3fa782 using xmllint with --postvalid showed me an error 
cannot use <group/> inside a <term/> (or maybe outside of a <cmdsynopsis/> or
<synoptfragment/>; removed the <group/> elements
 2016-03-02 20:53:31 -08:00
Martin A. Brown 9c42724bcc massive <itemize/> start/end tag corrections 
I don't know how this document ever validated before.  There were countless
locations where there were extra </itemize> closing tags and tons of missing
<itemize> opening tags.

I tried not to do any violence to the nesting, but it was very difficult to
understand, given the ambiguity.  The document now validates and can be built.
 2016-03-02 11:32:05 -08:00
Martin A. Brown 3262a09901 first of a series of open/close tag corrections 2016-03-02 09:19:54 -08:00
Martin A. Brown 5af31e0d30 removing NCURSES-HOWTO (cruft) 
the entire set of directories here had been checked in (in 2005) under
NCURSES-Programming-HOWTO; and has since been moved to a subdirectory,
NCURSES-Programming-HOWTO/resources

this is cruft and does not need to be here (there are even newer files in the
NCURSES-Programming-HOWTO/resources/ncurses_programs directory
 2016-03-01 20:45:49 -08:00
Martin A. Brown a4c4f094a1 retiring the never finished LVM-on-IDE-RAID-HOWTO 2016-03-01 20:41:03 -08:00
Martin A. Brown f2042fe71c correcting DocBook XML V4.2 PUBLIC identifier 2016-03-01 20:38:14 -08:00
Martin A. Brown 1135cacdf1 setting the document stem name to the directory stem name 2016-03-01 20:36:32 -08:00
Jason S. Evans e9722bc2a6 Merge https://github.com/tldp/ldp 2016-02-29 10:08:58 +01:00
Martin A. Brown e8fe102d0a moving out of the active source tree set 2016-02-26 08:32:18 -08:00
Jason S. Evans 95e73c8a11 Merge https://github.com/tldp/ldp 2016-02-26 09:22:57 +01:00
Martin A. Brown be5a5fc1b1 more updates to User-Group-HOWTO.sgml (Rick Moen) 
Would you mind doing that once again to revise to a yet-newer revision
(1.8.6)?  Still at http://linuxmafia.com/lug/User-Group-HOWTO.sgml .
 2016-02-25 12:31:39 -08:00
Martin A. Brown a9170ae47d Rick Moen is updating the User-Group-HOWTO 
From: Rick Moen <rick@linuxmafia.com>
To: discuss@en.tldp.org
Subject: Linux User Group HOWTO v. 1.8.5 ready
Date: Thu, 25 Feb 2016 04:30:58

Good folks, I have a major revamp of HOWTO ready for the submission
process.

http://linuxmafia.com/lug/User-Group-HOWTO.sgml

This is Linuxdoc SGML, selected by original author Kendall Grant Clark
back in 1997.  I've verified clean parsing of this revision.
HTML output here:  http://linuxmafia.com/lug/User-Group-HOWTO.html

Licence has been modified slightly on this release from the prior
CC BY-SA 3.0, to CC BY-SA 4.0 (current revision).  CC BY-SA is listed as
an accepted licence on http://wiki.tldp.org/LdpWikiDefaultLicence ,
and I doubt the revamped licence text would create any problme.  (If
LDP has a problem with 4.0, I will back-rev that.)

I hope someone will do me the courtesy of picking up the SGML file and
feeding it into GitHub.  Please advise.  Thank you!

--
Cheers,                  QA engineer walks into a bar.  Orders a beer.
Rick Moen                Orders 0 beers.  Orders 999999999 beers.  Orders
rick@linuxmafia.com      a lizard.  Orders -1 beers.  Orders a sfdeljknesv.
McQ! (4x80)              -- @sempf, https://www.sempf.net/post/On-Testing1.aspx
 2016-02-25 08:40:04 -08:00
Jason S. Evans d9a5616e66 Merge https://github.com/tldp/ldp 2016-02-25 09:44:48 +01:00
Martin A. Brown 79dcbec5a0 retire rpmupgrade 
retire unfinished document
 2016-02-24 11:19:14 -08:00
Martin A. Brown 12387813db retiring GNU-Build-System-HOWTO 
retiring GNU-Build-System-HOWTO after discussing with Giridhar
 2016-02-24 11:01:16 -08:00
Martin A. Brown 072ebcb987 remove endterm attribute from <xref/> elements 
Several <xref/> elements used the endterm attribute, which takes the entire
content contained in the element as replacement.  Because the endterm was
also, for example, a <section/>, the replaced text was a gigantic (multi-page)
link with the whole section included.  Unintended, I'm sure.
 2016-02-24 09:49:11 -08:00
Jason S. Evans 7089b157c2 Merge https://github.com/tldp/ldp 2016-02-24 09:32:27 +01:00
Martin A. Brown ad9b24cf03 amusing evidence of tables having grown from the original size (a common error, it seems) 2016-02-23 23:05:59 -08:00
Martin A. Brown 3a9a328a00 amusing evidence of tables having grown from the original size (a common error, it seems) 2016-02-23 23:05:59 -08:00
Martin A. Brown 6252e034eb amusing evidence of tables having grown from the original size (a common error, it seems) 2016-02-23 23:05:59 -08:00
Martin A. Brown 78ec6080e6 suppress docbook processors on book/articles for predictability during automation 2016-02-23 23:04:35 -08:00
Martin A. Brown 3ace57308c suppress dbhtml processors (automation prep) 
The <?dbhtml ...?> processor commands often create files that are unusually
named and not what the supermajority of our other documents use.
 2016-02-19 01:02:01 -08:00
Jason S. Evans cb75d5ab53 Update fork 
Merge https://github.com/tLDP/LDP
 2016-02-17 09:20:55 +01:00
Jason S. Evans 271ef7a63a Continuing work on document. 2016-02-16 07:10:01 +01:00
Martin A. Brown 9b265eb6e2 added section on bufferbloat; reworked language 
reworked some of the language for smoothness
added a section on bufferbloat (which still needs some editorial love)
 2016-02-13 00:13:46 -08:00
Martin A. Brown 9be89fd712 minor relanguaging 2016-02-13 00:13:31 -08:00
Martin A. Brown 30cb48755f xref to bufferbloat; tag "upgrade"; BQL title 
added a reference to bufferbloat
upgraded a few untagged text items to be wrapped with <command>, a few others
from <command> to the more appropriate <emphasis> or <constant>
added a FIXME for more description on enqueuing from userspace/network
 2016-02-13 00:08:18 -08:00
Martin A. Brown 850c1bfa91 from itemizedlist to varlistentry; image to table 
created priority map table as a DocBook table
altered several itemizedlist to varlistentry elements
 2016-02-13 00:05:08 -08:00
Martin A. Brown 0f250e9561 Merge branch 'master' of github.com:martin-a-brown/LDP 2016-02-12 10:57:05 -08:00
Martin A. Brown 4d5dcc5145 fixing dilemma and a stray helping verb 2016-02-12 10:56:21 -08:00
Martin A. Brown cee57524e7 Merge branch 'master' of https://github.com/tLDP/LDP 2016-02-12 10:54:38 -08:00
Martin A. Brown a4c900c3ba Merge branch 'master' of https://github.com/tLDP/LDP 2016-02-12 10:53:55 -08:00
Martin A. Brown a215c5153e correcting DOCTYPE declaration 2016-02-10 08:50:41 -08:00
Martin A. Brown ea092ea4de correcting DOCTYPE declaration 2016-02-10 08:49:50 -08:00
Brandon High 9da553be15 Grammar/spelling fixes for Bash Prog Intro 
This commit contains some minor grammatical/spelling fixes
for the Bash Programming Into HOWTO.
 2016-02-09 14:11:32 -08:00
Martin A. Brown 478d00191c retiring, per discussion on discuss@en.tldp.org 2016-02-09 08:05:15 -08:00
Jason S. Evans 7f28c38fcb updatng fork 
Merge https://github.com/tLDP/LDP
 2016-02-08 14:15:32 +00:00
Martin A. Brown 81f7d55069 list out new schedulers that should be documented 
Since the initial release of this document, there have been quite a few new
queuing disciplines added.  Identify the ones for which there is no
documentation here.
 2016-02-07 10:40:59 -08:00
Martin A. Brown d946dacabe Removing professional background references 
It is not necessary to credit SecurePipe, Inc. in every single file,
especially since it was merely my employer and did not actually contribute
materially to the documentation.  (As much as I appreciated the experience,
knowledge, role and professional growth.)
 2016-02-07 10:31:46 -08:00
Jason S. Evans 14e6e10ae4 Basic housecleaning and removed excessive files 2016-02-07 09:19:32 +01:00
Martin A. Brown 59ec37c19e adjusting definition URL to canonical location (so catalogs can find the DTD) 2016-02-05 20:17:28 -08:00
Jason S. Evans 8cbf688a88 Moved document from guides directory to howto direction and renamed file to match the standard naming convention. 2016-02-04 19:10:47 +01:00
Martin A. Brown c966065632 changing title 2016-02-02 19:13:13 -08:00
Martin A. Brown bb5f707742 template renaming 2016-02-02 19:11:32 -08:00
Martin A. Brown d851cd4f67 patches from Federico and Natale obviate this comment! 2016-02-02 10:09:19 -08:00
Martin A. Brown e01dc6f7f1 removing distracting and extraneous comment block 2016-02-02 10:08:41 -08:00
Martin A. Brown 0b2b5e0187 bumping VERSION to 1.1 2016-02-02 10:08:22 -08:00
Martin A. Brown 7099e84ec4 adding entries for Federico Bolelli and Natale Patriciello 2016-02-02 10:08:10 -08:00
Martin A. Brown a6502fbe1e adjusting references to LARTC mailing list and archives 2016-02-02 10:07:35 -08:00
Martin A. Brown b647cb5001 correcting URL for http://www.docum.org/docum.org/ (OK, weird) 2016-02-02 10:00:41 -08:00
Martin A. Brown 4eba0aa5a8 retiring Cyrillic-HOWTO 2016-02-02 09:26:12 -08:00
Martin A. Brown 05d19e3790 retiring Deciding-Linux-HOWTO 2016-02-02 09:25:25 -08:00
Martin A. Brown 0da3f7d73b retiring Dialup-PPP-Server-HOWTO 2016-02-02 09:24:45 -08:00
Martin A. Brown 9c4f4a5291 retiring IPTables 2016-02-02 09:20:24 -08:00
Martin A. Brown 0a1253f5fd retiring kde-compile 2016-02-02 09:19:40 -08:00
Martin A. Brown 06375137fb retiring Kernel-Build-HOWTO 2016-02-02 09:19:05 -08:00
Martin A. Brown 903b50b154 retiring lamp.sgml 2016-02-02 09:18:20 -08:00
Martin A. Brown 1a7074827c retiring Ldap-Implementation-HOWTO 2016-02-02 09:17:12 -08:00
Martin A. Brown d9b8b252de retiring Linux-Daemon-HOWTO 2016-02-02 09:15:58 -08:00
Martin A. Brown 71cbf78aac uppercasing the Storage in the name (matching to output tree) 2016-02-02 09:13:56 -08:00
Martin A. Brown 01ccf39090 uppercasing the Storage in the name (matching to output tree) 2016-02-02 09:13:44 -08:00
Martin A. Brown beb5efd0ef uppercasing the Storage in the name (matching to output tree) 2016-02-02 09:13:12 -08:00
Martin A. Brown 53b38cfa3d retiring Win+BSD+Linux-Install-HOWTO 2016-02-02 09:04:02 -08:00
Martin A. Brown 8be4bcded6 retiring the VirtulWeb-HOWTO 2016-02-02 08:53:26 -08:00
Martin A. Brown 8b1cf796e6 retiring the Anti-Spam-HOWTO 2016-02-02 08:53:06 -08:00
Martin A. Brown 826e647bce link target correction sect2 -> step2 
DocBook processor was complaining about the unknown link target for sect2.
This was just an obvious fix.  There remains an unknown linkend, booklist.
 2016-02-02 07:28:33 -08:00
Martin A. Brown 69eecf0cd4 creating and populating ./images/ directory 
document already referred to an images directory, but (for whatever reason)
the images were stored in the same directory as the DocBook XML source
 2016-02-02 07:22:31 -08:00
Martin A. Brown b7ff6aa7ae renaming according to convention 2016-02-02 07:18:29 -08:00
Martin A. Brown 3b3dca8f37 replacing typo angle bracket with parenthesis 2016-02-02 07:17:14 -08:00
Martin A. Brown a432c311d0 Merge remote-tracking branch 'origin/traffic' 2016-01-29 09:19:46 -08:00
Martin A. Brown 96e5f7e1bc removed inappropriate use of <xref endterm=""/> 
This document used an endterm in the wrong place and its presence was
confusing the heck out of the FO processor:

  <xref endterm="partitiontable" linkend="partitiontable" />

The endterm="" attribute tells the DocBook processor to copy the content found
at the linkend inline.  The problem is that the content at this particular
linkend was an entire table.  This meant that the FO processor was receiving
an entire (DocBook) table (as FO, of course) and futilely trying to render it
inline.

Removing the endterm="partitiontable" allows the document to be processed by
FOP into a PDF.
 2016-01-28 12:10:59 -08:00
Martin A. Brown 4212b180ab patched from author's github.com repository 
Author contacted, responded quickly, provided the missing old files
and confirmed that it was acceptable to comment out the reference to
../openMosix-2.6-HOWTO/openMosix-2.6-HOWTO-content.sgml

Source available: https://github.com/KrisBuytaert/openmosix-howto
 2016-01-28 10:26:32 -08:00
Martin A. Brown 40a544910f patched from author's github.com repository 
Author contacted, responded quickly, provided the missing old files
and confirmed that it was acceptable to comment out the reference to
../openMosix-2.6-HOWTO/openMosix-2.6-HOWTO-content.sgml

Source available: https://github.com/KrisBuytaert/openmosix-howto
 2016-01-28 10:23:42 -08:00
Martin A. Brown a092444e12 DocBook corrections and adjusting INCLUDE for LDP 
The desired output formats can be tweaked by setting the value of the
parameter entities %output.print.png% (and friends) to "INCLUDE";

The document still needed a few corrections, namely the removal of two
extraneous </listitem> elements and a few <application/> and <acronym/>
elements that were in illegal locations (for example as a child of the
<contrib> element).
 2016-01-27 22:52:21 -08:00
Martin A. Brown 99a64e441c Retiring the SGML version, since XML is much newer 2016-01-27 21:20:38 -08:00
Martin A. Brown 107e57c615 Correcting the system identifier in the DOCTYPE 
Using the HTTP variant of the system identifier; let the local DocBook
installation map that system identifier to the local filesystem for us.

Replacing two literal < with &lt;.
 2016-01-27 21:19:10 -08:00
Martin A. Brown 3b55146b71 adding images to big-howto-template and renaming 
The Template-Big-HOWTO.sgml contained references to images that were not
present in the VCS.  I located green.gif and red.gif in the ancient Linux
Gazette materials and added them here, along with a few .eps files for print
outputs.
 2016-01-27 21:07:26 -08:00
Martin A. Brown b9d0f98f4b Creating ./images/ directory and moving all *.png 
The publication scripts expect all images to be in a directory called
./images/ in order to be published in the HTML output directory.
 2016-01-27 21:05:14 -08:00
Martin A. Brown 08ac878b71 Switching to DocBook 4.2, to match markup 
The markup in this document made plenty of references to elements that
post-date the DocBook 3.0 specification (e.g. <mediaobject/>).

Fortunately, with one or two minor corrections to the nesting of elements, the
newer revision of DocBook can validate the document.
 2016-01-27 20:59:34 -08:00
Martin A. Brown fbedac7019 removing Framebuffer-HOWTO.sgml, replaced in 2010 by Framebuffer-HOWTO.XML 2016-01-27 18:20:36 -08:00
Federico Bolelli 35b2dce9ec Fixed Martin's comments 2016-01-27 12:42:14 +01:00
Federico Bolelli 3e267b0adc Overview updated 
Added the structure of the network stack, starvation and latency
 2016-01-27 12:42:14 +01:00
Federico Bolelli 239c98cd29 Added netfilter and iptables 
Also added ethtool for managing the driver queue
 2016-01-27 12:42:14 +01:00
Federico Bolelli df629eac5e Elements of traffic control updated 
Added the section on the driver queue (BQL)
 2016-01-27 12:42:14 +01:00
Federico Bolelli b6cde69c6f Classless qdisc updated 2016-01-27 12:42:14 +01:00
Federico Bolelli c1374527e7 Classful qdisc updated 2016-01-27 12:42:14 +01:00
Martin A. Brown 80be51b8b6 replacing an entity with the symbol, tilde; the entity was confusing TeX 2016-01-26 16:59:57 -08:00
Martin A. Brown 538ccf9083 making the doctype the first line to allow automated detection of contents 2016-01-25 15:05:45 -08:00
Martin A. Brown e0fda8a644 making the doctype the first line to allow automated detection of contents 2016-01-25 15:05:26 -08:00
Martin A. Brown dd4488d832 making the doctype the first line to allow automated detection of contents 2016-01-25 15:05:10 -08:00
Martin A. Brown 2f41c92aa7 making the doctype the first line to allow automated detection of contents 2016-01-25 15:04:46 -08:00
Martin A. Brown b1c2b644b1 making the doctype the first line to allow automated detection of contents 2016-01-25 15:04:27 -08:00
Martin A. Brown f20e3f92f2 making the doctype the first line to allow automated detection of contents 2016-01-25 15:04:08 -08:00
Martin A. Brown c1348baa89 making the doctype the first line to allow automated detection of contents 2016-01-25 15:03:51 -08:00
Martin A. Brown acd3de59fb making the doctype the first line to allow automated detection of contents 2016-01-25 15:03:27 -08:00
Martin A. Brown 6a510b0040 making the doctype the first line to allow automated detection of contents 2016-01-25 15:03:08 -08:00
Martin A. Brown 9e0f4c9e72 making the doctype the first line to allow automated detection of contents 2016-01-25 15:00:56 -08:00
Martin A. Brown 4ab81491b9 making the doctype the first line to allow automated detection of contents 2016-01-25 14:59:52 -08:00
Martin A. Brown 1b55ad1e15 making the doctype the first line to allow automated detection of contents 2016-01-25 14:59:19 -08:00
Martin A. Brown 47bc66db74 making the doctype the first line to allow automated detection of contents 2016-01-25 14:58:46 -08:00
Martin A. Brown 0547954349 making the doctype the first line to allow automated detection of contents 2016-01-25 14:58:21 -08:00
Martin A. Brown 01b734e282 making the doctype the first line to allow automated detection of contents 2016-01-25 14:58:00 -08:00
Martin A. Brown 245a8eaf5d making the doctype the first line to allow automated detection of contents 2016-01-25 14:57:13 -08:00
Martin A. Brown 5807da740c making the doctype the first line to allow automated detection of contents 2016-01-25 14:56:21 -08:00
Martin A. Brown 1a930dd14f making the doctype the first line to allow automated detection of contents 2016-01-25 14:55:57 -08:00
Martin A. Brown b73cbb4599 making the doctype the first line to allow automated detection of contents 2016-01-25 14:55:27 -08:00
Martin A. Brown e25f39cc2a making the doctype the first line to allow automated detection of contents 2016-01-25 14:54:48 -08:00
Martin A. Brown 10e7f1e27e making the doctype the first line to allow automated detection of contents 2016-01-25 14:54:08 -08:00
Martin A. Brown 6a94af9d85 making the doctype the first line to allow automated detection of contents 2016-01-25 14:53:40 -08:00
Martin A. Brown 7c1140b656 making the doctype the first line to allow automated detection of contents 2016-01-25 14:53:00 -08:00
Martin A. Brown 9e674c391f making the doctype the first line to allow automated detection of contents 2016-01-25 14:52:52 -08:00
Martin A. Brown a85c074a41 making the doctype the first line to allow automated detection of contents 2016-01-25 14:45:46 -08:00
Martin A. Brown 5368a9c844 openjade does not like underscore in id= attribute 
replace all underscores in attribute ids with dashes
 2016-01-25 12:37:14 -08:00
Martin A. Brown 133de6bb95 openjade does not like underscore in id= attribute 
replace all underscores in attribute ids with dashes
 2016-01-25 12:35:44 -08:00
Martin A. Brown e99c425209 DocBook SGML: openjade forbids underscore in id= 2016-01-25 09:52:11 -08:00
Martin A. Brown bd48a44b6a allow automated publishing; switch to ./resources/ 
The additional programs and content were stored in a directory called
ncurses_programs and were referred to in the document--the problem is that
only ./images/ were copied to the output tree, so HTML versions of the
document would fail in building AND the files would not be viewable.

Adjusted that be creating a ./resources/ directory along the same line
as the ./images/ directory.  This can be changed, if desired, but this
allows for automated publication of the document.  (Side benefit: this is
generalizable to all other TLDP documents.)
 2016-01-25 09:28:17 -08:00
Martin A. Brown 3b3973c134 DocBook SGML corrections 
replacing several bare ampersands with &amp;
 2016-01-25 08:53:59 -08:00
Martin A. Brown 470d6e8b1a renaming IRC.sgml to IRC.xml because it contains XML 2016-01-25 08:48:22 -08:00
Martin A. Brown 1ed75f296b rename the local index.sgml to slovak-index.sgml 
When generating a book (or article) index, the filename is index.sgml.  Not an
issue with DocBook XML, only with the older tools which make several passes
over the input sources to create the index data (output as SGML in a file
called index.sgml) and then incorporate that into the final document.
 2016-01-24 15:59:04 -08:00
Martin A. Brown 1cddadd624 DocBook SGML corrections 
removing extraneous and empty <author/>, non-validating <toc/>
replacing an <ulink/> with a mailto: with an <email/> element
stuffing an &amp; in the url="" attribute value for a <ulink/>
document now validates
 2016-01-24 15:52:34 -08:00
Martin A. Brown a16ca96a2b adjusting file path so that images files are available in output tree, as well; ./images/ 2016-01-24 15:43:25 -08:00
Martin A. Brown f77693c57c move images into own ./images/ dir so available in output tree 2016-01-24 15:41:11 -08:00
Martin A. Brown b4b4e106f1 moving images into ./images/ directory so that they are available in output tree, as well 2016-01-24 15:37:33 -08:00
Martin A. Brown e40a3fbe95 deleting two older copies of the same file with slightly different names 2016-01-24 15:37:06 -08:00
Martin A. Brown c379fe0e27 DocBook XML validation correction 
one extra </revision> closing tag needed to be removed
 2016-01-24 15:36:32 -08:00
Martin A. Brown 05f3196fbd moving images into ./images/ directory so that they are available in output tree, as well 2016-01-24 15:30:35 -08:00
Martin A. Brown 598373154c create actual .eps files and move image files into ./images/ 2016-01-24 15:26:21 -08:00
Martin A. Brown 5532c48b03 create actual .eps files and move image files into ./images/ 2016-01-24 15:25:52 -08:00
Martin A. Brown feb2db2a02 duplicate of VPN-SSH-PPP-HOWTO 2016-01-24 15:21:16 -08:00
Martin A. Brown 918a352508 DocBook XML correction 
Though it is legal to define parameter entity substitutions in a
DTD's internal subset, you cannot actually use them there.  It is only
legal to use a parameter entity substitution in an external subset.

See this:
https://www.w3.org/TR/1998/REC-xml-19980210#wfc-PEinInternalSubset

Therefore, for the XML-RPC-HOWTO, the %GoodStyleSheets; definition is
left uncommented, but the suppression of the alternate definition of
legal.notice is commented out.

Document validates and processes correctly, now, using the legal.notice
definition intended.  N.B., there is no actual difference in the license
specified, just the markup used to communicate it.
 2016-01-24 12:16:43 -08:00
Martin A. Brown a0d0c2ddf9 DocBook XML DOCTYPE declaration correction 
Setting the (absent) system identifier.
 2016-01-24 12:14:56 -08:00
Martin A. Brown f9df6da482 DocBook SGML correction 
A Table of Contents is automatically generated; no need for a <toc/> element,
and needed to get rid of an extraneous "#"; validates and processing now
 2016-01-24 12:02:57 -08:00
Martin A. Brown 89e9153c4e DocBook XML adjustments 
first line of fdl.xml with XML text declaration was confusing xsltproc;
removed and things were fine, also removed commented out DOCTYPE declaration

used URI for DocBook 4.1.2 in system identifier in rpmupgrade.xml

commented out <xref endterm="xrefdemo" linked="xrefdemo" /> which was causing
a recursion error in the DocBook XSLT layer

document now validates and builds (except for PDF)
 2016-01-24 11:58:27 -08:00
Martin A. Brown b9601025f3 locating all eps files in images directory 2016-01-24 11:42:18 -08:00
Martin A. Brown 9525ad00db adding .eps versions of all files for print output 2016-01-24 11:30:47 -08:00
Martin A. Brown 2769f0ac5f moving all images into images directory 2016-01-24 11:26:55 -08:00
Martin A. Brown 2fdfa2d74c drop all images into ./images/ directory 2016-01-24 11:22:58 -08:00
Martin A. Brown bb5aa4728f DocBook SGML correction 
The <mediaobject/> element does not allow the align= attribute, removing, to
allow validation and processing.
 2016-01-24 11:20:57 -08:00
Martin A. Brown c12f52be91 switching to entity names for &raquo; and &laquo; 2016-01-24 11:17:27 -08:00
Martin A. Brown faeb213288 DocBook SGML corrections 
Adding a variety of closing tags, </para>, </sect3> to allow for validation
 2016-01-24 11:09:30 -08:00
Martin A. Brown a8c934f589 DocBook SGML correction 
adding one missing </sect2> to allow for document validation
 2016-01-24 10:55:49 -08:00
Martin A. Brown e076e8194f DocBook SGML correction 
adding one missing </listitem> to allow for document validation
 2016-01-24 10:54:21 -08:00
Martin A. Brown b5a6449317 DocBook SGML corrections 
jade processor was very unhappy to have closing tags on <imagedata>;
removing them (which felt like violence) allowed the document to be
validated and processed
 2016-01-24 09:40:13 -08:00
Martin A. Brown c422768d80 DocBook SGML corrections 
The <email> start tag was not properly closed; just closing it.
 2016-01-24 09:36:46 -08:00
Martin A. Brown d51e1970c4 Store the cooked outputs of Charles Curley's scripts 
In his document build system, each script is cooked (wrapped in <![ CDATA []]>
during build process--this is elegant, but we are not calling his build
Makefile, so we need to store the cooked scripts in the source tree.
 2016-01-24 09:16:45 -08:00
Martin A. Brown 270d39e7de DocBook SGML corrections 
<artheader/> element removed, replaced with <articleinfo/> in DocBook 4.1
putting images in ./images/ directory
 2016-01-24 09:01:36 -08:00
Martin A. Brown bceac870e9 providing local copy of fdl.sgml.en, so the directory is self-contained 2016-01-24 08:54:50 -08:00
Martin A. Brown 3725584abc DocBook SGML corrections 
jade did not like trying to process <graphic/> elements where it could not
find the source images; also, it wanted the filename extension included (did
early DocBook SGML processing tools simply locate an image of the preferred
type?)
 2016-01-24 08:52:54 -08:00
Martin A. Brown b3c9d1fbf2 DocBook SGML corrections 
adding one closing </para>
commenting out <imageobject/> referring to png filetypes, since
the jade engine refuses to handle png files at DocBook v3.1
 2016-01-23 23:54:24 -08:00
Martin A. Brown e53cae8f61 DocBook SGML corrections 
element <authorintials/> spelled correctly as <authorinitials/>
added closing </para> and </listitem> to allow document to validate
 2016-01-23 23:49:06 -08:00
Martin A. Brown d2afd0d672 Merge branch 'master' of github.com:martin-a-brown/LDP 2016-01-23 21:50:45 -08:00
Martin A. Brown ffeea48757 using nicer callouts found in OpenSUSE 
Thanks to the OpenSUSE team, will add a note there.  Stuff is GFDL-1.2
 2016-01-23 21:50:05 -08:00
Martin A. Brown d21def7354 renaming rpmupgrade.sgml (directory) to rpmupgrade 
the automated processing script expects rpmupgrade/rpmupgrade.sgml
 2016-01-23 21:02:29 -08:00
Martin A. Brown ec5afa9517 adding compatibility symlink for VPN-PPP-SSH-HOWTO 
the processing tools expect each document to be STEM/STEM.sgml
or STEM/STEM.xml; in order to find the master document
 2016-01-23 21:00:36 -08:00
Martin A. Brown fd5a90d879 DocBook SGML validation fix 
Georg Käfer had to become Georg K&auml;fer for SGML, anyway; the
problem was not in the generation of HTML, but rather PDF output
through the tex engine
 2016-01-23 20:57:23 -08:00
Martin A. Brown 81f787ca3d Merge branch 'master' of github.com:martin-a-brown/LDP 2016-01-23 19:42:11 -08:00
Martin A. Brown 771b45718d incorporating admon graphics directly into Traffic-Control-HOWTO project 2016-01-23 19:41:37 -08:00
Martin A. Brown 13943cb7fb DocBook validation corrections 
changing all <link xlink:href=""/> elements to <ulink url=""/>;
this document is DocBook 4.1.2, and the use of xlink:href="" instead of the
more general <ulink/> element was preventing proper processing of the
document (without making the processor aware of this particular namespace)
HOWTO can be processed now by a completely automated (xsltproc) toolchain.
 2016-01-22 16:40:14 -08:00
Martin A. Brown 33d16b47d8 DocBook validation corrections 
changing & to &amp; to allow proper XML processing (e.g. xsltproc)
 2016-01-20 21:07:33 -08:00
Martin A. Brown 872986dacf DOCTYPE declaration correction to allow xsltproc to process document 2016-01-20 21:02:36 -08:00
Martin A. Brown 73310be57f Unicode correction 
Add BOM and save the file as a Unicode data file, so that xsltproc can process
the data.
 2016-01-20 20:54:00 -08:00
Martin A. Brown a1d93005c4 DocBook validation corrections 
changing & to &amp; to allow proper XML processing (e.g. xsltproc
 2016-01-20 20:49:07 -08:00
Martin A. Brown b9068e9954 DocBook validation corrections 
changing < to &lt; to allow proper XML processing (e.g. xsltproc)
 2016-01-20 20:47:53 -08:00
Martin A. Brown 93d5814837 DOCTYPE declaration correction to allow xsltproc to process document 2016-01-20 20:46:42 -08:00
Martin A. Brown b546ae028d DOCTYPE declaration correction to allow xsltproc to process document 2016-01-20 20:43:37 -08:00
Martin A. Brown a9c9c5a2e9 Merge branch 'master' of github.com:martin-a-brown/LDP 2016-01-20 09:19:46 -08:00
Martin A. Brown dcb0116ad2 DocBook validation corrections 
adding a missing closing </listitem>, </sect2> and a few </para> elements
 2016-01-20 09:12:15 -08:00
Karel Vlk 9301f63a43 change preposition 
"same as" sounds better than "same than"
 2016-01-19 15:49:58 +01:00
Martin A. Brown 1f0afa18e5 removing, since renamed in 2004 (more than 10 years ago) 2016-01-18 10:43:44 -08:00
Martin A. Brown 8e8b80b1f4 DocBook validation correction 
adding closing tags for several <sect2/> <listitem/> and <para/> to
allow validation
 2016-01-18 10:38:47 -08:00
Martin A. Brown 047c5460c4 switching all sect4 to sect2 (sect4 cannot be direct child of sect1) 2016-01-18 10:04:44 -08:00
Martin A. Brown 6803385e51 linuxdoc validation improvement 
replacing HTML <a href=""> with <url url="">
 2016-01-17 17:50:24 -08:00
Martin A. Brown 2ea10d2df3 linuxdoc validation improvement 
needed something (anything) in the entry for Primary Contact so that the
processor would stop complaining about </descrip>
 2016-01-17 17:48:47 -08:00
Martin A. Brown 5dcc946eb6 linuxdoc validation improvement 
replacing HTML <a href=""> with <url url="">
 2016-01-17 17:44:36 -08:00
Martin A. Brown ca2237d9d6 linuxdoc validation improvement 
replacing literal [] with &lsqb; and &rsqb to quell complaints from the
processor
 2016-01-17 14:37:09 -08:00
Martin A. Brown 1d7010ae4f linuxdoc validation improvement 
replacing HTML <a href=""> with <url url="">
 2016-01-17 14:36:03 -08:00
Martin A. Brown 1fda1be405 linuxdoc validation improvement 
replacing HTML <a href=""> with <url url="">
 2016-01-17 14:35:21 -08:00
Martin A. Brown 7735a074d2 linuxdoc validation improvement 
replacing HTML <a href=""> with <url url="">
 2016-01-17 14:34:02 -08:00
Martin A. Brown 63361970a0 linuxdoc validation improvement 
replacing HTML <a href=""> with <url url="">
 2016-01-17 14:33:00 -08:00
Martin A. Brown adbd380601 linuxdoc validation improvement 
replacing literal [] with &lsqb; and &rsqb to quell complaints from the
processor
 2016-01-17 14:31:20 -08:00
Martin A. Brown 7be4cdfcaf linuxdoc validation improvement 
replacing byte 0x96 with an &ntilde; to quell complaints from the processor
 2016-01-17 14:29:24 -08:00
Martin A. Brown 68be050317 linuxdoc validation improvement 
removing a <p> tag so that <abstract> is not prematurely closed
thus quelling complaints from the processor
 2016-01-17 14:26:53 -08:00
Martin A. Brown 278b0c88cd linuxdoc validation improvement 
spelling correction for <htmlurl>
 2016-01-17 14:25:38 -08:00
Martin A. Brown 15ebfa5237 linuxdoc validation improvement 
replacing literal [] with &lsqb; and &rsqb; and removing <em> from
abstract to quell complaints from the processor
 2016-01-17 14:23:53 -08:00
Martin A. Brown cb16691c27 linuxdoc validation improvement 
removing two <p> tags so that <abstract> is not prematurely closed;
effectively quells the complaints from the processor
 2016-01-17 14:20:07 -08:00
Martin A. Brown 2175ab6587 linuxdoc validation improvement 
ordering the preliminary content in the required order, (<abstract> and <toc>)
to quell griping from the processor
 2016-01-17 14:17:55 -08:00
Martin A. Brown 87b4b1cc57 linuxdoc validation improvement 
replacing nonexistent tag <filename> with <tt>
 2016-01-17 14:16:47 -08:00
Martin A. Brown f50331c08f linuxdoc validation improvement 
replacing HTML <a href=""> with <url url="">
 2016-01-17 14:10:44 -08:00
Martin A. Brown 740c3d37ef linuxdoc validation improvement 
use terse format for table, which had all of the closing tags jammed at the
end of the </tabular>
correct nesting of <item> elements in many <enum> and <itemize> elements
fix a few <url> elements
remove the 50-car pileup of closing tags at the end of the document
all in order to quell validation errors
 2016-01-17 14:07:36 -08:00
Martin A. Brown 863e0ea7c2 linuxdoc validation improvement 
moving <toc> higher to quell processor complaint
 2016-01-17 13:30:14 -08:00
Martin A. Brown 1af2625c74 linuxdoc validation improvement 
replacing HTML <a href=""> with <url url="">
 2016-01-17 13:29:41 -08:00
Martin A. Brown 8798746fce linuxdoc validation improvement 
replacing HTML <a href=""> with <url url="">
 2016-01-17 13:29:00 -08:00
Martin A. Brown 72c66680b5 linuxdoc validation improvement 
replacing HTML <a href=""> with <url url="">
replacing a pair of literal <> with &lt; and &gt;
 2016-01-17 13:26:18 -08:00
Martin A. Brown 488dc4aabb linuxdoc validation improvement 
replacing HTML <a href=""> with <url url="">
 2016-01-17 13:25:16 -08:00
Martin A. Brown 88d2c64a56 linuxdoc validation improvement 
swapping a close tag for </verb></tscreen> and an <nidx/> to make
the processor stop complaining
 2016-01-17 13:23:50 -08:00
Martin A. Brown 767ac8b375 linuxdoc validation improvement 
replacing HTML <a href=""> with <url url="">
 2016-01-17 13:15:46 -08:00
Martin A. Brown 354a652c07 linuxdoc validation improvement 
added <title> element to quell processor complaint
 2016-01-17 13:14:24 -08:00
Martin A. Brown 2bbb848b1c linuxdoc validation improvement 
flipping order of <author> and <date> element to quell processor
complaint
 2016-01-17 13:11:10 -08:00
Martin A. Brown 48ca326fb8 linuxdoc validation improvement 
replacing HTML <a href=""> with <url url="">
 2016-01-17 13:10:05 -08:00
Martin A. Brown 85d41c3c6b linuxdoc validation improvement 
using entities &rsqb; &lsqb; and &amp; instead of the literals to improve
validation; replacing HTML <a href=""> with <url url="">
 2016-01-17 13:08:06 -08:00
Martin A. Brown 9f9bf73232 linuxdoc validation improvement 
adding comment terminator --> where required
ordering the preliminary content in the required order, (title, author,
date, abstract, toc) in order to make the linuxdoc processor happier
 2016-01-17 12:56:08 -08:00
Martin A. Brown 754943d728 linuxdoc validation improvement 
replacing a pair of literal <> with &lt; and &gt; around an email address
 2016-01-17 12:50:18 -08:00
Martin A. Brown d5edb4d23c linuxdoc validation improvement 
adding missing </tt> tag
 2016-01-17 12:49:17 -08:00
Martin A. Brown 1d76da0713 linuxdoc validation improvement 
Needed to replace a literal & with &amp;
 2016-01-17 12:48:22 -08:00
Martin A. Brown 39dbf83a6a linuxdoc validation improvement 
processor was complaining about unescaped &lt; and &gt;
It was trying to use these as directives.
 2016-01-17 12:46:43 -08:00
Martin A. Brown c24ea6dc0e linuxdoc validation improvement 
nsgmls processor was complaining when trying to interpret an email
address as an element; just switched these to &lt; and &gt; and all
is well; also removed an extraneous trailing numeral '2' outside the document
structure
 2016-01-17 12:43:47 -08:00
Martin A. Brown 7c1a003765 linuxdoc validation improvement 
document had <sect3> children of <sect1>; processor complained about
it, but produced output, just quelling some of the noise.
 2016-01-17 12:42:09 -08:00
Martin A. Brown 0564618e20 document in wrong tree; is docbook, not linuxdoc 2016-01-17 12:37:55 -08:00
Martin A. Brown 743d55cf71 adjusting pathing for Large-Disk-Howto and referring to local resources 2016-01-17 12:32:19 -08:00