old-www/pub/Linux/docs/ldp-archived/mail_archives/ldp-discuss/msg02261.html

178 lines
7.1 KiB
HTML

<!-- MHonArc v2.5.0b2 -->
<!--X-Subject: Re: if SGML is so great... -->
<!--X-From-R13: Egrva Uwbra <ftwbraNznvy.alk.arg> -->
<!--X-Date: Thu, 4 May 2000 14:54:38 &#45;0400 (EDT) -->
<!--X-Message-Id: 3911C742.3AA77FD7@mail.nyx.net -->
<!--X-Content-Type: text/plain -->
<!--X-Reference: A5F46F4ED18FD211ABEE00105AC6CF077F805B@email.cu&#45;portland.edu -->
<!--X-Head-End-->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
<html>
<head>
<title>Re: if SGML is so great...</title>
<link rev="made" href="mailto:sgjoen@mail.nyx.net">
</head>
<body>
<!--X-Body-Begin-->
<!--X-User-Header-->
<!--X-User-Header-End-->
<!--X-TopPNI-->
<hr>
[<a href="msg02260.html">Date Prev</a>][<a href="msg02262.html">Date Next</a>][<a href="msg02260.html">Thread Prev</a>][<a href="msg02312.html">Thread Next</a>][<a href="maillist.html#02261">Date Index</a>][<a href="threads.html#02261">Thread Index</a>]
<!--X-TopPNI-End-->
<!--X-MsgBody-->
<!--X-Subject-Header-Begin-->
<h1>Re: if SGML is so great...</h1>
<hr>
<!--X-Subject-Header-End-->
<!--X-Head-of-Message-->
<ul>
<li><em>To</em>: Gregory Leblanc &lt;<A HREF="mailto:GLeblanc@cu-portland.edu">GLeblanc@cu-portland.edu</A>&gt;</li>
<li><em>Subject</em>: Re: if SGML is so great...</li>
<li><em>From</em>: Stein Gjoen &lt;<A HREF="mailto:sgjoen@mail.nyx.net">sgjoen@mail.nyx.net</A>&gt;</li>
<li><em>Date</em>: Thu, 04 May 2000 20:53:54 +0200</li>
<li><em>Cc</em>: <A HREF="mailto:ldp-discuss@lists.linuxdoc.org">ldp-discuss@lists.linuxdoc.org</A></li>
<li><em>References</em>: &lt;<a href="msg02258.html">A5F46F4ED18FD211ABEE00105AC6CF077F805B@email.cu-portland.edu</a>&gt;</li>
<li><em>Resent-date</em>: Thu, 4 May 2000 14:54:38 -0400 (EDT)</li>
<li><em>Resent-from</em>: <A HREF="mailto:ldp-discuss@lists.debian.org">ldp-discuss@lists.debian.org</A></li>
<li><em>Resent-message-id</em>: &lt;lMmyd.A.qJD.ldcE5@murphy&gt;</li>
<li><em>Resent-sender</em>: <A HREF="mailto:ldp-discuss-request@lists.debian.org">ldp-discuss-request@lists.debian.org</A></li>
</ul>
<!--X-Head-of-Message-End-->
<!--X-Head-Body-Sep-Begin-->
<hr>
<!--X-Head-Body-Sep-End-->
<!--X-Body-of-Message-->
<pre>
Gregory Leblanc wrote:
&gt;
&gt; Finally, back to the real work. :-)
&gt; &gt; From: Stein Gjoen [<A HREF="mailto:sgjoen@mail.nyx.net">mailto:sgjoen@mail.nyx.net</A>]
&gt; &gt; Greg Ferguson wrote:
&gt; &gt; &gt; On May 3, 9:39am, Gregory Leblanc wrote:
&gt; &gt; &gt; &gt; &gt; Jorge Godoy wrote:
&gt; &gt; &gt; &gt; &gt; &gt; Stein Gjoen &lt;sgjoen@mail.nyx.net&gt; writes:
&gt; &gt; &gt; &gt; &gt; Interesting. How is it rendered, or is it at all?
I guess Ihave to read raw mapping files...
&gt; &gt; &gt; &gt; &gt; More importantly, where can I look to find out myself where
&gt; &gt; &gt; &gt; &gt; the tags are described without wading through masses of
&gt; &gt; &gt; &gt; &gt; incomprehensible datafiles?
&gt; &gt; &gt; &gt;
&gt; &gt; &gt; &gt; <A HREF="http://www.docbook.org/">http://www.docbook.org/</A> The last part of DocBook: TDG is a
&gt; &gt; &gt; &gt; comprehensive listing of all of the DocBook tags, with
&gt; &gt; descriptions,
&gt; &gt; &gt; &gt; examples, and some incomprehensible datafile stuff, which
&gt; &gt; I usually
&gt; &gt; &gt; &gt; ignore. I've considered buying the book, but it's FAR more useful
&gt; &gt; &gt; &gt; online than it would be a a desk reference for me.
&gt; &gt; &gt; &gt; Greg
&gt; &gt;
&gt; &gt; These details should go into a doc for authors, perhaps the
&gt; &gt; HOWTO-HOWTO. I do not have continuous access to the Internet
&gt; &gt; to look up these things so an on-disk reference would be
&gt; &gt; handy. From what I hear from others I am not alone in this
&gt; &gt; situation.
&gt; &gt;
&gt; &gt; &gt; There is also a tag-quick-reference table that Norm (Walsh,
&gt; &gt; author of
&gt; &gt; &gt; DocBook: TDG) and Leonard Muellner put together...
&gt; &gt; &gt;
&gt; &gt; &gt; DocBook V3.1 Quick Reference
&gt; &gt; &gt; <A HREF="http://www.nwalsh.com/docbook/defguide/qr/quickref.htm">http://www.nwalsh.com/docbook/defguide/qr/quickref.htm</A>
&gt; &gt; &gt;
&gt; &gt; &gt; lists &lt;tag&gt; and &lt;brief description&gt; only; but quite handy for
&gt; &gt; &gt; quick look-ups.
&gt; &gt;
&gt; &gt; I have the feeling this is DocBook DTD as opposed to the
&gt; &gt; LinuxDoc DTD, am I right? If so I'd like a similar reference
&gt; &gt; guide for the LinuxDoc DTD. Last night I took a long hard look
&gt; &gt; in the docs for SGMLTools and did not find what I needed there.
&gt;
&gt; Yep, that's DocBook. I think that the only such reference for the
&gt; LinuxDocDTD is the DTD itself. If you're using an RPM based distribution,
&gt; then 'rpm -ql sgmltools' will give you a listing where you can probably find
&gt; the DTD itself.
I use LinuxDoc from a DEB package. I used find and grep to locate
the files but that is not optimum.
Also online docs are not anoption when I write and that is the
situation for many others too. I need useful docs on my disk.
&gt; &gt; Finally there is no &lt;manpage&gt; like tag in the mapping nor in the
&gt; &gt; above mentioned references. A HOWTO reference tag would also be
&gt; &gt; nice.
&gt;
&gt; I think &lt;refentry&gt; is the DocBook tag, but I'm not 100% sure on that; I'm
&gt; fairly confident that LinuxDoc doesn't have anything useful for man pages.
&gt; As for the HOWTO reference tag, what do you mean? Godoy and I have talked
&gt; about getting a special document type for the LDP called HOWTO, but I'm not
&gt; sure if he made any progress on that. I'm not sure if you're looking for
&gt; something different in it's markup capabilities, or just in name.
My large reply crashed here so I'll rewrite it later. In summary
I feel we need more tags for our specific needs. SGML is
scalable and extensible, right?
Regards,
Stein Gjoen
--
To UNSUBSCRIBE, email to ldp-discuss-request@lists.debian.org
with a subject of &quot;unsubscribe&quot;. Trouble? Contact listmaster@lists.debian.org
</pre>
<!--X-Body-of-Message-End-->
<!--X-MsgBody-End-->
<!--X-Follow-Ups-->
<hr>
<ul><li><strong>Follow-Ups</strong>:
<ul>
<li><strong><a name="02312" href="msg02312.html">Re: if SGML is so great...</a></strong>
<ul><li><em>From:</em> Taketoshi Sano &lt;kgh12351@nifty.ne.jp&gt;</li></ul></li>
</ul></li></ul>
<!--X-Follow-Ups-End-->
<!--X-References-->
<ul><li><strong>References</strong>:
<ul>
<li><strong><a name="02258" href="msg02258.html">RE: if SGML is so great...</a></strong>
<ul><li><em>From:</em> Gregory Leblanc &lt;GLeblanc@cu-portland.edu&gt;</li></ul></li>
</ul></li></ul>
<!--X-References-End-->
<!--X-BotPNI-->
<ul>
<li>Prev by Date:
<strong><a href="msg02260.html">Re: if SGML is so great...</a></strong>
</li>
<li>Next by Date:
<strong><a href="msg02262.html">Re: SGML tools aren't so great</a></strong>
</li>
<li>Previous by thread:
<strong><a href="msg02260.html">Re: if SGML is so great...</a></strong>
</li>
<li>Next by thread:
<strong><a href="msg02312.html">Re: if SGML is so great...</a></strong>
</li>
<li>Index(es):
<ul>
<li><a href="maillist.html#02261"><strong>Date</strong></a></li>
<li><a href="threads.html#02261"><strong>Thread</strong></a></li>
</ul>
</li>
</ul>
<!--X-BotPNI-End-->
<!--X-User-Footer-->
<!--X-User-Footer-End-->
</body>
</html>