This is the mail archive of the davenport@berkshire.net mailing list for the Davenport project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]

Re: DAVENPORT: DocBook for documenting Python code



    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.

    Konrad> Assuming that I remember all the two dozen shortcuts for
    Konrad> the markup.  But typing time isn't the major issue, it's
    Konrad> *reading* time. Even with Emacs' syntax coloring, I find
    Konrad> it hard to spot the real text hidden in the markup.

Konrad, fortunately your problems are all of a kind that is easy to
solve.  PSGML-mode also has a "hide markup" option in the menus
somewhere (I forget the keystroke :-)).

WYSIWYG rendering would be quite nice, as would FM+SGML's structure
view.  But I am much faster at authoring with emacs+PSGML, because I
don't have to look for things to click.



Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]