Everyone, Progress was slow today. I started out well, but then I ran into Documentation.htm. Progress slowed considerably, as I analyzed the document structure. I''m up to /etc/shorewall/hosts Configuration. I hope to finish Documentation.xml by tomorrow evening. Converted documents: 6to4.xml CorpNetwork.xml FAQ.xml Please post feedback, if you see any problems with the converted content. Thanks. -- Mike Noyes <mhnoyes at users.sourceforge.net> http://sourceforge.net/users/mhnoyes/ SF.net Projects: ffl, leaf, phpwebsite, phpwebsite-comm, sitedocs
On Wed, 2003-12-10 at 17:17, Mike Noyes wrote:> Please post feedback, if you see any problems with the converted > content. Thanks.Everyone, I''m looking for someone to do the DocBook XML conversion on the French translated documents. Anyone willing to volunteer? French documents: standalone_fr.html shorewall_setup_guide_fr.htm three-interface_fr.html two-interface_fr.html -- Mike Noyes <mhnoyes at users.sourceforge.net> http://sourceforge.net/users/mhnoyes/ SF.net Projects: ffl, leaf, phpwebsite, phpwebsite-comm, sitedocs
Mike, Please all forgive the top-posting -- I''m using OE. As I''ve already mentioned I updated the FAQ.xml to include a copyright and to reflect the legacy FAQ number (which you had already encoded using the ''id'' tag). Other than that, I''ve generated xhtml using xsltproc and have published the converted pages to Sourceforge and the mirrors. If it''s any consolation, Documentation.htm is by far the largest of the existing HTML docs :-) -Tom -- Tom Eastep \ Nothing is foolproof to a sufficiently talented fool Shoreline, \ http://www.shorewall.net Washington USA \ teastep@shorewall.net ----- Original Message ----- From: "Mike Noyes" <mhnoyes@users.sourceforge.net> To: <shorewall-devel@lists.shorewall.net> Sent: Wednesday, December 10, 2003 5:17 PM Subject: [Shorewall-devel] DocBook XML conversion progress> Everyone, > Progress was slow today. I started out well, but then I ran into > Documentation.htm. Progress slowed considerably, as I analyzed the > document structure. I''m up to /etc/shorewall/hosts Configuration. I hope > to finish Documentation.xml by tomorrow evening. > > Converted documents: > 6to4.xml > CorpNetwork.xml > FAQ.xml > > Please post feedback, if you see any problems with the converted > content. Thanks. > > -- > Mike Noyes <mhnoyes at users.sourceforge.net> > http://sourceforge.net/users/mhnoyes/ > SF.net Projects: ffl, leaf, phpwebsite, phpwebsite-comm, sitedocs > > _______________________________________________ > Shorewall-devel mailing list > Shorewall-devel@lists.shorewall.net > https://lists.shorewall.net/mailman/listinfo/shorewall-devel >
On Wed, 2003-12-10 at 17:17, Mike Noyes wrote:> Converted documents: > 6to4.xml > CorpNetwork.xml > FAQ.xmlDocumentation.xml The file I just finished had a few broken internal links. I wasn''t able to figure out where they should go. Section without id: /etc/shorewall/common Missing id: Scripts Starting LogUnclean NatEnabled GettingStarted Unclean MangleEnabled FW Missing url: Shorewall-docs/Accounting.html Shorewall-docs/User_defined_Actions.html> Please post feedback, if you see any problems with the converted > content. Thanks.-- Mike Noyes <mhnoyes at users.sourceforge.net> http://sourceforge.net/users/mhnoyes/ SF.net Projects: ffl, leaf, phpwebsite, phpwebsite-comm, sitedocs
On Friday 12 December 2003 10:27 pm, Mike Noyes wrote:> > Documentation.xml > > The file I just finished had a few broken internal links. I wasn''t able > to figure out where they should go. > > Section without id: > /etc/shorewall/common > > Missing id: > Scripts > Starting > LogUnclean > NatEnabled > GettingStarted > Unclean > MangleEnabled > FWI''ll work on those.> > Missing url: > Shorewall-docs/Accounting.html > Shorewall-docs/User_defined_Actions.html >Those pages have been added to CVS. Thanks! -Tom -- Tom Eastep \ Nothing is foolproof to a sufficiently talented fool Shoreline, \ http://shorewall.net Washington USA \ teastep@shorewall.net
On Sat, 2003-12-13 at 10:14, Tom Eastep wrote:> On Friday 12 December 2003 10:27 pm, Mike Noyes wrote: > > Documentation.xml > > > > The file I just finished had a few broken internal links. I wasn''t able > > to figure out where they should go. > > I''ll work on those.Tom, I think I finally understand what you are doing in Documentation.xml. You are trying to create man page type reference sections. Do you think the attached tarball represents your intent better than the original conversion? Note: I have almost no experience with synopsis creation, so someone else would need to work on them. One benefit of this approach: we should be able to build man pages from these files. -- Mike Noyes <mhnoyes at users.sourceforge.net> http://sourceforge.net/users/mhnoyes/ SF.net Projects: ffl, leaf, phpwebsite, phpwebsite-comm, sitedocs -------------- next part -------------- A non-text attachment was scrubbed... Name: reference.tgz Type: application/x-gzip Size: 12210 bytes Desc: not available Url : http://lists.shorewall.net/pipermail/shorewall-devel/attachments/20031213/6c9fba2c/reference.bin
Hi Mike, On 13 Dec 2003, Mike Noyes wrote:> I think I finally understand what you are doing in Documentation.xml. > You are trying to create man page type reference sections. Do you think > the attached tarball represents your intent better than the original > conversion? > > Note: I have almost no experience with synopsis creation, so someone > else would need to work on them. > > One benefit of this approach: we should be able to build man pages from > these files. >I think that what you included in the tarball is a worthwhile goal -- Let''s not try to do it now though but rather let''s wait until the conversion of the other documents is complete. -Tom -- Tom Eastep \ Nothing is foolproof to a sufficiently talented fool Shoreline, \ http://shorewall.net Washington USA \ teastep@shorewall.net
On Sat, 2003-12-13 at 14:40, Tom Eastep wrote: On 13 Dec 2003, Mike Noyes wrote:> > I think I finally understand what you are doing in Documentation.xml. > > You are trying to create man page type reference sections. Do you think > > the attached tarball represents your intent better than the original > > conversion? > > I think that what you included in the tarball is a worthwhile goal -- > Let''s not try to do it now though but rather let''s wait until the > conversion of the other documents is complete.Tom, Will do. I''ll try to get a couple more done tomorrow morning. Then I''ll start up again on Mon. I must watch football. ;) -- Mike Noyes <mhnoyes at users.sourceforge.net> http://sourceforge.net/users/mhnoyes/ SF.net Projects: ffl, leaf, phpwebsite, phpwebsite-comm, sitedocs
On 13 Dec 2003, Mike Noyes wrote:> Will do. I''ll try to get a couple more done tomorrow morning. Then I''ll > start up again on Mon. > > I must watch football. ;)Man cannot live by Docbook along :-) -Tom -- Tom Eastep \ Nothing is foolproof to a sufficiently talented fool Shoreline, \ http://shorewall.net Washington USA \ teastep@shorewall.net
On Fri, 2003-12-12 at 22:27, Mike Noyes wrote:> On Wed, 2003-12-10 at 17:17, Mike Noyes wrote: > > Converted documents: > > 6to4.xml > > CorpNetwork.xml > > FAQ.xml > Documentation.xmlEveryone, These documents are now converted. ECN.xml FTP.xml GenericTunnels.xml GnuCopyright.xml IPIP.xml IPSEC.xml Tom converted these: Shorewall_Doesnt.xml quotes.xml releasenotes.xml shorewall_features.xml shorewall_prerequisites.xml> > Please post feedback, if you see any problems with the converted > > content. Thanks.We need to create a DocBook XSL Stylesheet customization layer for DTD element ''ulink'' attribute ''type'', so we can generate the proper HTML element ''a'' attribute ''target''. Specifically, we need a way to generate target=_top for specific URLs. Part III. Customizing DocBook XSL Chapter 10. HTML customizations http://www.sagehill.net/docbookxsl/HtmlCustomEx.html -- Mike Noyes <mhnoyes at users.sourceforge.net> http://sourceforge.net/users/mhnoyes/ SF.net Projects: ffl, leaf, phpwebsite, phpwebsite-comm, sitedocs
On Tue, 2003-12-16 at 16:28, Mike Noyes wrote:> On Fri, 2003-12-12 at 22:27, Mike Noyes wrote: > > On Wed, 2003-12-10 at 17:17, Mike Noyes wrote: > > > Converted documents: > > > 6to4.xml > > > CorpNetwork.xml > > > FAQ.xml > > Documentation.xml > ECN.xml > FTP.xml > GenericTunnels.xml > GnuCopyright.xml > IPIP.xml > IPSEC.xmlEveryone, These files were converted yesterday. Install.xml MAC_Validation.xml Multiple_Zones.xml NAT.xml NetfilterOverview.xml Attached is a sample HOWTO template from The Linux Documentation Project. I changed all the sect? tags to section. The original is here: http://tldp.org/authors/index.html#resources http://tldp.org/authors/template/Sample-HOWTO.xml> Tom converted these: > Shorewall_Doesnt.xml > quotes.xml > releasenotes.xml > shorewall_features.xml > shorewall_prerequisites.xml > > > > Please post feedback, if you see any problems with the converted > > > content. Thanks.-- Mike Noyes <mhnoyes at users.sourceforge.net> http://sourceforge.net/users/mhnoyes/ SF.net Projects: ffl, leaf, phpwebsite, phpwebsite-comm, sitedocs -------------- next part -------------- A non-text attachment was scrubbed... Name: Sample-HOWTO.xml.gz Type: application/x-gzip Size: 2287 bytes Desc: not available Url : http://lists.shorewall.net/pipermail/shorewall-devel/attachments/20031218/f82e4514/Sample-HOWTO.xml.bin
On Thu, 2003-12-18 at 08:23, Mike Noyes wrote:> Attached is a sample HOWTO template from The Linux Documentation > Project. I changed all the sect? tags to section. > > The original is here: > http://tldp.org/authors/index.html#resources > http://tldp.org/authors/template/Sample-HOWTO.xmlEveryone, Sorry for the first attachment. I didn''t review the file well enough. TLDP is still using an incorrect DOCTYPE declaration. Attached is a revised copy. You can diff it against TLDP version for changes. -- Mike Noyes <mhnoyes at users.sourceforge.net> http://sourceforge.net/users/mhnoyes/ SF.net Projects: ffl, leaf, phpwebsite, phpwebsite-comm, sitedocs -------------- next part -------------- A non-text attachment was scrubbed... Name: Sample-HOWTO.xml.gz Type: application/x-gzip Size: 2289 bytes Desc: not available Url : http://lists.shorewall.net/pipermail/shorewall-devel/attachments/20031218/44ba4c52/Sample-HOWTO.xml.bin
On Thu, 2003-12-18 at 08:23, Mike Noyes wrote:> On Tue, 2003-12-16 at 16:28, Mike Noyes wrote: > > On Fri, 2003-12-12 at 22:27, Mike Noyes wrote: > > > On Wed, 2003-12-10 at 17:17, Mike Noyes wrote: > > > > Converted documents: > > > > 6to4.xml > > > > CorpNetwork.xml > > > > FAQ.xml > > > Documentation.xml > > ECN.xml > > FTP.xml > > GenericTunnels.xml > > GnuCopyright.xml > > IPIP.xml > > IPSEC.xml > Install.xml > MAC_Validation.xml > Multiple_Zones.xml > NAT.xml > NetfilterOverview.xmlEveryone, Yesterday was a complete loss. I''ll see if I can get some conversions done today. -- Mike Noyes <mhnoyes at users.sourceforge.net> http://sourceforge.net/users/mhnoyes/ SF.net Projects: ffl, leaf, phpwebsite, phpwebsite-comm, sitedocs
On Sat, 2003-12-20 at 10:40, Mike Noyes wrote:> > Everyone, > Yesterday was a complete loss. I''ll see if I can get some conversions > done today.No problem -- I''m currently working on ''shorewall_quickstart_guide.htm''. I''ll be doing the French Guides next. I''m doing these docs now to resolve character set problems. -Tom -- Tom Eastep \ Nothing is foolproof to a sufficiently talented fool Shoreline, \ http://shorewall.net Washington USA \ teastep@shorewall.net
On Sat, 20 Dec 2003, Tom Eastep wrote:> On Sat, 2003-12-20 at 10:40, Mike Noyes wrote: > > > > > Everyone, > > Yesterday was a complete loss. I''ll see if I can get some conversions > > done today. > > No problem -- I''m currently working on ''shorewall_quickstart_guide.htm''. > I''ll be doing the French Guides next. > > I''m doing these docs now to resolve character set problems. >I''ve completed: standalone_fr.htm two-interface_fr.htm -Tom -- Tom Eastep \ Nothing is foolproof to a sufficiently talented fool Shoreline, \ http://shorewall.net Washington USA \ teastep@shorewall.net
On Sun, 21 Dec 2003, Tom Eastep wrote:> > I''ve completed: > > standalone_fr.htm > two-interface_fr.htm >I also completed shorewall_quickstart_guide.htm -Tom -- Tom Eastep \ Nothing is foolproof to a sufficiently talented fool Shoreline, \ http://shorewall.net Washington USA \ teastep@shorewall.net
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
OK folks. I''m working on whitelisting_under_shorewall and will then
move
to VPN and on up. I''ll keep up on progress posts.
- --
Paul <snafu@forkbomb.dhs.org>
BLOG: http://forkbomb.dhs.org/bs/
GPG Key: http://forkbomb.dhs.org/bs/snafu.asc
- ---
Life would be so much easier if we could just look at the source code.
-- Dave Olson
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.3 (GNU/Linux)
iD8DBQE/5w6PNQvzkbg+TpsRAvdAAJ9sbBd0orF3TVy1F2F4icHQpCy5sACghXfS
p5bROiMy3vhRJ1R6BHmYtp0=BqXW
-----END PGP SIGNATURE-----
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
whitelisting_under_shorewall.xml has been checked in for aproval.
You guys don''t really want the usefull_links.htm converted?
I''m assuming
no, and moving to upgrade_issues.htm
- --
Paul <snafu@forkbomb.dhs.org>
BLOG: http://forkbomb.dhs.org/bs/
GPG Key: http://forkbomb.dhs.org/bs/snafu.asc
- ---
Life would be so much easier if we could just look at the source code.
-- Dave Olson
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.3 (GNU/Linux)
iD8DBQE/50DdNQvzkbg+TpsRAq3RAJ44CXQNX02pzmrzNEsxpkGcbqOJ3gCghCD/
sJ8wIiwYseyoO16C17g4K60=A8/I
-----END PGP SIGNATURE-----
On Mon, 2003-12-22 at 11:07, Paul wrote:> whitelisting_under_shorewall.xml has been checked in for aproval. > > You guys don''t really want the usefull_links.htm converted? I''m assuming > no, and moving to upgrade_issues.htmPaul, It''s tagged for conversion. $ cvs status -v useful_links.html ==================================================================File: useful_links.html Status: Up-to-date Working revision: 1.6 Repository revision: 1.6 /usr/local/cvs/Shorewall-docs/useful_links.html,v Sticky Tag: (none) Sticky Date: (none) Sticky Options: (none) Existing Tags: convert2docbook (revision: 1.5) -- Mike Noyes <mhnoyes at users.sourceforge.net> http://sourceforge.net/users/mhnoyes/ SF.net Projects: ffl, leaf, phpwebsite, phpwebsite-comm, sitedocs
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Mike Noyes wrote:> On Mon, 2003-12-22 at 11:07, Paul wrote: > >>whitelisting_under_shorewall.xml has been checked in for aproval. >> >>You guys don''t really want the usefull_links.htm converted? I''m assuming >>no, and moving to upgrade_issues.htm > > > Paul, > It''s tagged for conversion.h''ok then. I''ll check in the xml in 10 minutes ;-) - -- Paul <snafu@forkbomb.dhs.org> BLOG: http://forkbomb.dhs.org/bs/ GPG Key: http://forkbomb.dhs.org/bs/snafu.asc - --- Life would be so much easier if we could just look at the source code. -- Dave Olson -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.3 (GNU/Linux) iD8DBQE/50MXNQvzkbg+TpsRAi2eAJ9ND9QeVf8NZaT9Fvhs57BMovqYuQCfbb6R /PFSUQYkUnyrdCQ7J04Esu4=WYv2 -----END PGP SIGNATURE-----
On Mon, 2003-12-22 at 11:07, Paul wrote:> whitelisting_under_shorewall.xml has been checked in for aproval.Paul, That file fails validation in 11 places. Please correct the validation errors. Thanks. Please run xmllint on all files prior to committing. $ xmllint --valid --noout whitelisting_under_shorewall.xml XXE has a validator also. Tools -> Check Validity -- Mike Noyes <mhnoyes at users.sourceforge.net> http://sourceforge.net/users/mhnoyes/ SF.net Projects: ffl, leaf, phpwebsite, phpwebsite-comm, sitedocs
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Mike Noyes wrote:> On Mon, 2003-12-22 at 11:07, Paul wrote: > >>whitelisting_under_shorewall.xml has been checked in for aproval. > > > Paul, > That file fails validation in 11 places. Please correct the validationSeems theres a discrepancy in Docbook''s docs. Informaltable states that it can have a parent of figure, but figure states that informalpara is not allowed to be a child. Will fix this issue. - -- Paul <snafu@forkbomb.dhs.org> BLOG: http://forkbomb.dhs.org/bs/ GPG Key: http://forkbomb.dhs.org/bs/snafu.asc - --- Life would be so much easier if we could just look at the source code. -- Dave Olson -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.3 (GNU/Linux) iD8DBQE/50gRNQvzkbg+TpsRAhOFAJwJti/ZRmd9vQtBexCF+tPbaXBZTQCaA9Xc eBHtGDxXImnyw6ERamcxbJA=LmoI -----END PGP SIGNATURE-----
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Mike Noyes wrote:> On Mon, 2003-12-22 at 11:30, Paul wrote: > >>Mike Noyes wrote: >> >>>That file fails validation in 11 places. Please correct the validation >>>errors. Thanks.Already fixed. -- Paul <snafu@forkbomb.dhs.org> BLOG: http://forkbomb.dhs.org/bs/ GPG Key: http://forkbomb.dhs.org/bs/snafu.asc - --- Life would be so much easier if we could just look at the source code. -- Dave Olson -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.3 (GNU/Linux) iD8DBQE/50qPNQvzkbg+TpsRAlzEAJ4xJAxlsb7JV/EShSeFiGhBpmYKgwCeL3oD v3lpktNy5WpM2HnKf4/cJtg=o0wK -----END PGP SIGNATURE-----
On Mon, 2003-12-22 at 11:48, Paul wrote:> Mike Noyes wrote: > > On Mon, 2003-12-22 at 11:30, Paul wrote: > > > >>Mike Noyes wrote: > >> > >>>That file fails validation in 11 places. Please correct the validation > >>>errors. Thanks. > > Already fixed.Paul, Thanks. A few things: Please add an ID of the filename to the article tag. e.g. <article id="ProxyARP"> Please use ISO date format YYYY-MM-DD. Tom uses "Thomas M. Eastep" for the copyright name. ref. bottom of html files or new xml source. Why are there comments? -- Mike Noyes <mhnoyes at users.sourceforge.net> http://sourceforge.net/users/mhnoyes/ SF.net Projects: ffl, leaf, phpwebsite, phpwebsite-comm, sitedocs
On Monday 22 December 2003 11:07 am, Paul wrote:> -----BEGIN PGP SIGNED MESSAGE----- > Hash: SHA1 > > whitelisting_under_shorewall.xml has been checked in for aproval. >Paul, Please don''t include my email address in the author information. I get enough SPAM already. Thanks, -Tom -- Tom Eastep \ Nothing is foolproof to a sufficiently talented fool Shoreline, \ http://shorewall.net Washington USA \ teastep@shorewall.net
On Mon, 2003-12-22 at 11:37, Paul wrote:> Seems theres a discrepancy in Docbook''s docs. Informaltable states that > it can have a parent of figure, but figure states that informalpara is > not allowed to be a child.Paul, This may be one of the changes from 4.1.x to 4.2. -- Mike Noyes <mhnoyes at users.sourceforge.net> http://sourceforge.net/users/mhnoyes/ SF.net Projects: ffl, leaf, phpwebsite, phpwebsite-comm, sitedocs
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Mike Noyes wrote:> On Mon, 2003-12-22 at 11:48, Paul wrote:> A few things: > > Please add an ID of the filename to the article tag. > e.g. <article id="ProxyARP"> > > Please use ISO date format YYYY-MM-DD. > > Tom uses "Thomas M. Eastep" for the copyright name. > ref. bottom of html files or new xml source. > > Why are there comments?Done done and done. I''m not allowed to use comments? Sorry, seems a bit odd to me, I''ve always commented my code. Is it that you''re using that XXE program and it does not look well with comments in it? Tom: removed your address. - -- Paul <snafu@forkbomb.dhs.org> BLOG: http://forkbomb.dhs.org/bs/ GPG Key: http://forkbomb.dhs.org/bs/snafu.asc - --- Life would be so much easier if we could just look at the source code. -- Dave Olson -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.3 (GNU/Linux) iD8DBQE/51FJNQvzkbg+TpsRAq95AJ9chS+X2ZK0JdgeJ2KaqmufQblNFQCdGAv3 KZv85VriZxy2uCzu6dSNuzw=KFK1 -----END PGP SIGNATURE-----
On Mon, 2003-12-22 at 12:17, Paul wrote:> Mike Noyes wrote: > > Why are there comments? > > I''m not allowed to use comments? Sorry, seems a bit odd to me, I''ve > always commented my code. Is it that you''re using that XXE program and > it does not look well with comments in it?Paul, Comments are fine, but the ones that were included seemed redundant. I was wondering if they were being inserted by your editor. -- Mike Noyes <mhnoyes at users.sourceforge.net> http://sourceforge.net/users/mhnoyes/ SF.net Projects: ffl, leaf, phpwebsite, phpwebsite-comm, sitedocs
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Mike Noyes wrote:> On Mon, 2003-12-22 at 12:17, Paul wrote: > Paul, > Comments are fine, but the ones that were included seemed redundant. I > was wondering if they were being inserted by your editor.Redundant? Hmmm... I''m not using any special editor. Working in text mode. - -- Paul <snafu@forkbomb.dhs.org> BLOG: http://forkbomb.dhs.org/bs/ GPG Key: http://forkbomb.dhs.org/bs/snafu.asc - --- Life would be so much easier if we could just look at the source code. -- Dave Olson -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.3 (GNU/Linux) iD8DBQE/51OqNQvzkbg+TpsRAqbYAJ0VldoH24kC1/Jx1k7ytENPjcL3kwCfTQ6f rFGFP3S2xEq1zP8qsRXd0bA=ZYXe -----END PGP SIGNATURE-----
On Mon, 2003-12-22 at 12:27, Paul wrote:> Mike Noyes wrote: > > Comments are fine, but the ones that were included seemed redundant. I > > was wondering if they were being inserted by your editor. > > Redundant? Hmmm...Examples: <!-- Zone File --> <bridgehead renderas="sect4">Zone File</bridgehead> <!-- Interfaces File --> <bridgehead renderas="sect4">Interfaces File</bridgehead> Paul, I guess it''s just style. I don''t use many comments. Tom should probably comment here.> I''m not using any special editor. Working in text mode.You are more familiar with the DocBook DTD than I am. I would have tons of errors without a parsing editor (emacs+psgml, xxe, etc.). -- Mike Noyes <mhnoyes at users.sourceforge.net> http://sourceforge.net/users/mhnoyes/ SF.net Projects: ffl, leaf, phpwebsite, phpwebsite-comm, sitedocs
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Mike Noyes wrote:> On Mon, 2003-12-22 at 12:27, Paul wrote: > >>Mike Noyes wrote: >> >>>Comments are fine, but the ones that were included seemed redundant. I >>>was wondering if they were being inserted by your editor. >> >>Redundant? Hmmm... > > > Examples: > > <!-- Zone File --> > <bridgehead renderas="sect4">Zone File</bridgehead> > > <!-- Interfaces File --> > <bridgehead renderas="sect4">Interfaces File</bridgehead> > > Paul, > I guess it''s just style. I don''t use many comments. Tom should probably > comment here.Since the tables get quite large in parts, I''ve added the comment to help tell them apart should you be using a text mode editor. You''re not, so it seems a bit pointless to you. Not sure what Tom is using either, assuming xxe. If you''d like me to keep the comment noise down, say the word. It may, however, make life easier if you''re ever stuck in text mode or someone esle maintains the documents.> You are more familiar with the DocBook DTD than I am. I would have tons > of errors without a parsing editor (emacs+psgml, xxe, etc.).There is some autocompletion here, but it''s support is minimal. It''s all very logical of course once you get the hang of it. Commiting usefull_links.xml now. Should be it for the day, I have a meeting then off to shop for the kiddies. Back later around 10 and forge on. - -- Paul <snafu@forkbomb.dhs.org> BLOG: http://forkbomb.dhs.org/bs/ GPG Key: http://forkbomb.dhs.org/bs/snafu.asc - --- Life would be so much easier if we could just look at the source code. -- Dave Olson -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.3 (GNU/Linux) iD8DBQE/51jjNQvzkbg+TpsRAqiFAJ9BD88Rd1zVSEQKmtqFKUY595hELACdGi72 tVFWA51WW2OH/JTMNnQ8Nqo=iU+k -----END PGP SIGNATURE-----
On Mon, 2003-12-22 at 12:49, Paul wrote:> Mike Noyes wrote: > > Examples: > > > > <!-- Zone File --> > > <bridgehead renderas="sect4">Zone File</bridgehead> > > > > <!-- Interfaces File --> > > <bridgehead renderas="sect4">Interfaces File</bridgehead>Paul, Just a style question. Why did you use bridgehead instead of section? I thought any bridgehead that required a renderas was appropriate for consideration as a section. Am I misunderstanding the DTD? Note: I try to keep with the simplified tags when possible. http://www.docbook.org/tdg/simple/en/html/sdocbook.html -- Mike Noyes <mhnoyes at users.sourceforge.net> http://sourceforge.net/users/mhnoyes/ SF.net Projects: ffl, leaf, phpwebsite, phpwebsite-comm, sitedocs
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Mike Noyes wrote:> On Mon, 2003-12-22 at 12:49, Paul wrote:> Paul, > Just a style question. Why did you use bridgehead instead of section? I > thought any bridgehead that required a renderas was appropriate for > consideration as a section. Am I misunderstanding the DTD? > > Note: I try to keep with the simplified tags when possible. > http://www.docbook.org/tdg/simple/en/html/sdocbook.html >Just seemed appropriate I suppose. I could turn them into sect''s if preferred. - -- Paul <snafu@forkbomb.dhs.org> BLOG: http://forkbomb.dhs.org/bs/ GPG Key: http://forkbomb.dhs.org/bs/snafu.asc - --- Life would be so much easier if we could just look at the source code. -- Dave Olson -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.3 (GNU/Linux) iD8DBQE/52HCNQvzkbg+TpsRAvODAJwJqR2+JtQxQBILwWvbLtjMjBSnzACfTsYQ wMsfLFasWcpDOf/pJA1dSD8=5xvm -----END PGP SIGNATURE-----
On Mon, 22 Dec 2003, Mike Noyes wrote:> On Mon, 2003-12-22 at 12:27, Paul wrote: > > Mike Noyes wrote: > > > Comments are fine, but the ones that were included seemed redundant. I > > > was wondering if they were being inserted by your editor. > > > > Redundant? Hmmm... > > Examples: > > <!-- Zone File --> > <bridgehead renderas="sect4">Zone File</bridgehead> > > <!-- Interfaces File --> > <bridgehead renderas="sect4">Interfaces File</bridgehead> > > Paul, > I guess it''s just style. I don''t use many comments. Tom should probably > comment here. >I''m rather indifferent -- I use a parsing editor (xxe) and the comments are a bit of an annoyance there. On the other hand, I can see where comments would be useful if I was caught without xxe/emacs and had to make a change.> > I''m not using any special editor. Working in text mode. > > You are more familiar with the DocBook DTD than I am. I would have tons > of errors without a parsing editor (emacs+psgml, xxe, etc.).Me too. -Tom -- Tom Eastep \ Nothing is foolproof to a sufficiently talented fool Shoreline, \ http://shorewall.net Washington USA \ teastep@shorewall.net
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
Morning all, working on upgrade_issues conversion now.
- --
Paul <snafu@forkbomb.dhs.org>
BLOG: http://forkbomb.dhs.org/bs/
GPG Key: http://forkbomb.dhs.org/bs/snafu.asc
- ---
Life would be so much easier if we could just look at the source code.
-- Dave Olson
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.3 (GNU/Linux)
iD8DBQE/6G0JNQvzkbg+TpsRAgqHAJ4mwb6ks9ncZftx4fpr2AeqAb7ZJgCaA3Zv
IIVVL+YOWlIXoOIavWbi2RA=c0Yb
-----END PGP SIGNATURE-----
On Tuesday 23 December 2003 08:27 am, Paul wrote:> -----BEGIN PGP SIGNED MESSAGE----- > Hash: SHA1 > > Morning all, working on upgrade_issues conversion now.I''ve started on troubleshoot.htm. -Tom -- Tom Eastep \ Nothing is foolproof to a sufficiently talented fool Shoreline, \ http://shorewall.net Washington USA \ teastep@shorewall.net
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Paul wrote:> Morning all, working on upgrade_issues conversion now.Checked in now. Prob needs some touch-ups, on my home from work now. More later. - -- Paul <snafu@forkbomb.dhs.org> BLOG: http://forkbomb.dhs.org/bs/ GPG Key: http://forkbomb.dhs.org/bs/snafu.asc - --- Life would be so much easier if we could just look at the source code. -- Dave Olson -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.3 (GNU/Linux) iD8DBQE/6MSyNQvzkbg+TpsRAgi4AJ45Un7Hr/IQlEyzVTu6OiVH7CZvOwCfeJ// 2ifWIkxfExXEeBfuafwt6BI=LVHj -----END PGP SIGNATURE-----
On Tuesday 23 December 2003 02:41 pm, Paul wrote:> -----BEGIN PGP SIGNED MESSAGE----- > Hash: SHA1 > > Paul wrote: > > Morning all, working on upgrade_issues conversion now. > > Checked in now. Prob needs some touch-ups, on my home from work now. > More later.Thanks, Paul. -Tom -- Tom Eastep \ Nothing is foolproof to a sufficiently talented fool Shoreline, \ http://shorewall.net Washington USA \ teastep@shorewall.net
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Mike Noyes wrote: | Paul, | I''ve attached the template I''m using for new documents. Is it not advisable to use <quote></quote> instead of character codes? - -- Paul <snafu@forkbomb.dhs.org> BLOG: http://forkbomb.dhs.org/bs/ GPG Key: http://forkbomb.dhs.org/bs/snafu.asc - --- Life would be so much easier if we could just look at the source code. ~ -- Dave Olson -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.3 (GNU/Linux) iD8DBQE/6fw2NQvzkbg+TpsRAofgAKCIBwGpo1wy6LoE135EIIA/XwqqTACdFlxg YQsPSRGvWM0W8kJX89vakWk=KebR -----END PGP SIGNATURE-----
On Wed, 2003-12-24 at 12:51, Paul S. wrote:> -----BEGIN PGP SIGNED MESSAGE----- > Hash: SHA1 > > Mike Noyes wrote: > | Paul, > | I''ve attached the template I''m using for new documents. > > Is it not advisable to use <quote></quote> instead of character codes?Paul, You are correct <citetitle> or <quote> is appropriate. I apologize for the incorrect template. I haven''t been converting quotes in the documents. I figured we could change things like that during a conventions standardization pass. Should I make a search and replace run through the documents converting " to <quote></quote> pairs? Some of the quote pairs need to be <citetitle> though, so the conversion may not be straightforward. -- Mike Noyes <mhnoyes at users.sourceforge.net> http://sourceforge.net/users/mhnoyes/ SF.net Projects: ffl, leaf, phpwebsite, phpwebsite-comm, sitedocs
On Wed, 2003-12-24 at 13:11, Mike Noyes wrote:> Should I make a search and replace run through the documents > converting " to <quote></quote> pairs? Some of the quote pairs > need to be <citetitle> though, so the conversion may not be > straightforward.Everyone, I started conversion of " and ' pairs to <quote>. I didn''t convert any quote pairs within a programlisting tag. Now during a conventions pass we can convert them to the appropriate element. Example: citetitle command computeroutput userinput ... Tom, Here are the instructions for converting in xxe. XXE quote conversion: http://www.xmlmind.com/xmleditor/_distrib/docs/user/userguide3.html#id.s3.4.3.1 Click inside any quote and then click on word quote inside the node path bar. Now that quote is selected, use Edit|Convert to modify the quote. -- Mike Noyes <mhnoyes at users.sourceforge.net> http://sourceforge.net/users/mhnoyes/ SF.net Projects: ffl, leaf, phpwebsite, phpwebsite-comm, sitedocs