Re: doc-base 0.4 and other issues
On 16 Apr 1998, Adam P. Harris wrote:
> Christian Schwarz <firstname.lastname@example.org> writes:
> > On 16 Apr 1998, Adam P. Harris wrote:
> > > (a.3) Should we reconsider the 'document-id' system (one docid per
> > > file, many formats)? Wouldn't it make it easier for package
> > > maintainers to have a single file that could have multiple
> > > document-ids? Would this be a bad idea?
> > Huh? Sorry, but I don't get your point. The DOCID is used to identify a
> > document. It's like the `Package:' field of a .deb or `Source:' field of a
> > .dsc file. It _has_ to be unique, since that's what the field is for.
> > Note, that this field will also eventually be used for inter-document
> > cross-references, as what's planned for debiandoc-sgml.
> > Please give me more details about which problems you see with the current
> > use of the Document-ID field.
> Christian, I understand and do not question the notion that we need a
> unique documentid. (Although this raises the issue that we may need
> to put in processes to resolve conflicts.)
> I was questioning the fact that we have one and only one documentid
> per document control file. I was asking what are the good reasons (I
> know they're there) behind this so I can explain it as part of my new
> document registration file format standard.
Oh, sorry, I misunderstood your initial question.
Well, the only reason for having only one DOCID per registry file is that
it makes things easier for doc-base: How would you handle a situation
where a package, v1, included 2 documents registered via a single registry
file, and the next version, v2, only includes 1 of these documents,
registered in the same file? If this could be handled by doc-base some
way, you could have several DOCIDs per file--but I'm not sure it's worth
the efforts. (What's the problem for having one DOCID per file?)
-- _,, Christian Schwarz
/ o \__ email@example.com, firstname.lastname@example.org,
! ___; email@example.com, firstname.lastname@example.org
\\\______/ ! PGP-fp: 8F 61 EB 6D CF 23 CA D7 34 05 14 5C C8 DC 22 BA
\ / http://fatman.mathematik.tu-muenchen.de/~schwarz/
"DIE ENTE BLEIBT DRAUSSEN!"
To UNSUBSCRIBE, email to email@example.com
with a subject of "unsubscribe". Trouble? Contact firstname.lastname@example.org