[Bf-docboard] What about a chapter for "3D Concepts & Fundamentals"

[Felix Rabe]

Bart Veldhuizen wrote:
> Hmmm, this sounds like overkill to me. What's wrong with a plain text
> note with some references?

Absolutely nothing :).  It might just help to have it in a certain style 
that could be automatically processed later if we then think it could 
serve some purpose.  It wouldn't mean anything would get more 
complicated, it would just mean that not everybody would invent his own 
style of making those references, so that they are somewhat coherent.

The only "overkill" might be that somebody would set up an easy set of 
rules and write about it in the style section.

For example: (mind the '<'s and '>' if you should copy it)

"References are contained within <literallayout> elements, whose first 
contained word (the first non-whitespace characters) is 'Reference' 
(case-insensitive).  A reference URL is contained in a line starting 
with a free-standing 'o' (i.e., followed by whitespace), and the 
reference URL is everything beginning with the first non-whitespace 
character after the 'o' until the end of line (or the </literallayout>)."

Example:

<literallayout>
REFERENCES::
============

o http://this/
o mailto:that@something
o ftp://somewhere/

   o  http://special/reference/
      (treated exactly the same as the others)
</literallayout>

Simple, isn't it?  The list of references would thus be:

http://this/  mailto:that@something  ftp://somewhere/ 
http://special/reference/

The rest is simply ignored.

What do you think?

cu,
Felix