Re: Ada and Doxygen

[Stephen Leake <stephen_leake@stephe-leake.org>]

"Hibou57 (Yannick Duchêne)" <yannick_duchene@yahoo.fr> writes:

>>> Further more, this kind of browsing does not allow pre-designed
>>> navigation  paths (this is mainly random browsing -- random here, has
>>> the same meaning  as with random file access),
>>
>> Well, yes.
>>
>> If you want to write a tutorial, that's a separate document, not
>> source code.
> That's closer.
> Why did you use the word “ tutorial ” ? (just want to know, as this
> choice  may be potentially relevant)

Most documents I read that have "pre-designed navigation paths" are
tutorials. Or fiction novels, in another domain.

Reference manuals should not have pre-designed paths; they should
allow random access, with lots of cross-references.

-- 
-- Stephe