This is the mail archive of the
davenport@berkshire.net
mailing list for the Davenport project.
Re: DAVENPORT: DocBook for documenting Python code
> Konrad> I found that in many cases the markup is much longer than
> Konrad> the actual text!
>
> I think this is a common misconception. Abbreviations are not hard to
> program into your editor, so that you can do <emphasis> with a single
> keystroke.
Assuming that I remember all the two dozen shortcuts for the markup.
But typing time isn't the major issue, it's *reading* time. Even with
Emacs' syntax coloring, I find it hard to spot the real text hidden in
the markup.
--
-------------------------------------------------------------------------------
Konrad Hinsen | E-Mail: hinsen@cnrs-orleans.fr
Centre de Biophysique Moleculaire (CNRS) | Tel.: +33-2.38.25.55.69
Rue Charles Sadron | Fax: +33-2.38.63.15.17
45071 Orleans Cedex 2 | Deutsch/Esperanto/English/
France | Nederlands/Francais
-------------------------------------------------------------------------------