[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re^6: document registration policy needing to be written

Am 14.04.98 schrieb apharris # burrito.onshore.com ...

Moin Adam!

APH> Document: doc-base

What for is this?

APH> Title: Debian doc-base Manual

This is like my <linkname>?

APH> Author: Christian Schwarz

Do we need that?

APH> Abstract: This manual describes what doc-base is and how it can be used
APH> to  manage online manuals on Debian systems.

Ok, is should HTML be allowed?

APH> Section: Apps/Programming


APH> Format: debiandoc-sgml
APH> Files: /usr/doc/doc-base/doc-base.sgml.gz
APH> Format: text
APH> Files: /usr/doc/doc-base/doc-base.text.gz

I don#t understand that. Can every File can have its own Abstract for  
example? How can you recognize the beginning of the definition of a new  
document (like my <item></item>)?

APH> Format: HTML
APH> Index: /usr/doc/doc-base/doc-base.html/index.html
APH> Files: /usr/doc/doc-base/doc-base.html/*.html

What#s that? I don#t see any need for that. "File: " should be the root  
document (index.html in this example). That#s difficult to parse in C.

APH> Blech.  Disagree.  Arguably, flat text files are our standard format;

No, see Policy.

APH> a close runner up being debiandoc-sgml.  Anyhow, if you want to

Only very few packages use debiandoc.

APH> accomodate lazy pgk maintainers, it would be bettter to try to
APH> autoguess the format based on either the file magic (i.e., 'file') or
APH> the suffix.

The "file" program is no option for a C program. But you could use the  
.html, .ps at the end. But this would be difficult, if the file is  
compressed or it#s a SGML file (there#re several DTDs).

cu, Marco

Uni: Budde@tu-harburg.de           Fido: 2:240/5202.15
Mailbox: mbudde@hqsys.antar.com    http://www.tu-harburg.de/~semb2204/

To UNSUBSCRIBE, email to debian-doc-request@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org

Reply to: