procj EEV1 {tag text} {
  AL "eev.el.html[section $tag]" $text
}



htmlize {Edrx's Emacs page} {

[H2 eev.el and e-scripts]

[P [BF Short description:] eev.el lets you place hyperlinks and
shell/tcl/TeX/etc code inside plain text files. It is, IMNSHO, the
definitive argument to convert people to Unix and Emacs.]

[P If you are new to eev then [IT please] take a look at the [L
eev-manifesto.html eev Manifesto], at [L eev-mails.html some
descriptions of eev taken from mails I've sent], at [L hacks.html the
list of my favorite hacks] or at the raw [L escripts.html index of my
e-scripts repository]\; I'm trying to write an [L emacs-tutor.html
emacs tutorial from the eev point of view], but it is VERY far from
complete.]

[P Here are some direct links to the more important comments in the
eev.el code:]

[LIST1
  [EEV eev \"eev and friends\"...]
  [EEV eev-howto A quick eev how-to, if the above is too obscure.]
  [J Changes if you use eev with shells other than instead of zsh:
    notes on [EEV eev-bash bash] and [EEV eev-tcsh tcsh].]
  [J [EEV eelatex eelatex, an eev function for typesetting a block
    with LaTeX.] It is tuned to use the set of macros that I created
    for my Master's thesis (tese2.sty), and the [AL LATEX/Makefile
    Makefile in my LaTeX directory], which preprocesses the tmp.tex
    file with dednat.icn to let me embed deduction trees in the text.]
  [J [EEV bounded Bounded eev commands:] by assigning one of these to
    a key (F3, usually) I can eev the text between two delimiters,
    instead of having to mark it as a block manually. Very useful for
    eev'ing TeX, as TeX chunks are generally well over 100 lines.]
  [EEV eev_pre Basic building blocks for the eev functions.]
  [HLIST2 {Hyperlinks:}
    [J [EEV find- Here]'s the code for the two most basic hyperlink
      functions, find-fline and find-node.]
    [J [EEV code-c-d code-c-d], a factory of find-xxx functions.]
    [J [EEV ccd-exs Examples of usage of code-c-d.] Note that I have
      [AL {.emacs.html#code-c-ds} hundreds] of calls to code-c-d in my
      .emacs and that most of my files are full of usages of the
      find-xxxfile/find-xxxtag/etc functions that are generated by
      calls to code-c-d.]
    ]
  [J [EEV eeman eeman] is a strange hybrid between a find-xxxfunction
    and an eev-type function.]
  [J [EEV dff dff] is a macro to generate two find-xxx lines from the
    name of a debian package.]
  [J [EEV inn inn] can be used to generate a find-node line
    automatically.]
]

[P If you have any question about eev.el, glyphs or something related,
please [ML edrx@inx.com.br mail me]! I need to document this more, and
I don't know well how to start...]



[H2 Glyphs]

[P We can tell emacs, using [IT glyphs] and the [IT display table],
that certain characters are to be displayed as certain character
sequences\; on character terminals we can use this to obtain effects
like the first screenshot below -- that is, it becomes much easier to
edit math texts under emacs, especially because in text mode it is
very easy to change characters in a font: check [AL MTA/vtutil vtutil]
and [AL MTA/vtutilsh.c vtutilsh.c]. BTW, the second screenshot below
shows how [AL MTA/vtutil vtutil] appears on my screen (modulo the
aspect ratio, of course).]

[IMAGE a/IMAGES/emacsllded.png (screenshot, 4kB)]
[IMAGE a/IMAGES/emacsvtutil.png (screenshot, 7kB)]

[P (I don't know how to do this in X. If you know how to convert a
console font to an X font and make Emacs use it, please mail me.)]

[P Notes: [BF 1)] You can see at the second screenshot, if you pay a
lot of attention, that I still use the codepage 850 encoding (with
fonts that I stole from DOS's [TT EGA.CPI] with a home-grown HS-Forth
program back in 1995 :-). [BF 2)] Versions 20.1, 20.2 and 20.3 of
Emacs have a bug at handling glyphs for the chars 128..159\; this bug
is fixed on 20.4. I use Emacs19.34 at home and a 20.4 recompiled from
the original GNU source when I have to edit text on one of those
crappy RedHat distros. [BF 3)] Well, RedHat traditionally hates Emacs
anyway (no Emacs Lisp manuals, no gnuclient, and a ridiculous bug in
the Emacs package for RH5.0 that rendered [TT describe-key] and [TT
describe-function] unusable...) [BF 4)] Fat Smiling Torvalds also
hates Emacs, and see what's happening to the poor guy, he's getting
rich but is losing his soul. Hahaha. [BF 5)] As a curiosity, here's
[MYL a/glyphbug an e-script containing the bug report] that I sent to
the Emacs developers. Version 20.4 was already out when they received
it, so it was useless. :-(]




[P [L gnu.html Some links on GNU.]]

[HLIST1 {Links:}
  [L http://www.lerner.co.il/emacs/faq-body.shtml
    Emacs FAQ]
  [IFL L http://www.landfield.com/faqs/GNU-Emacs-FAQ/index.html
    Emacs FAQ (old link)]
  [L http://www.gnu.org/software/emacs/emacs.html
    ]
  [L http://www.emacs.org/
    ]
  [LR http://beta.emacs.org/
    ]
  [L http://homepage6.lcs.mit.edu/users/friedman/software/emacs-lisp/src/
    ]
  [L http://www.faqs.org/faqs/by-newsgroup/gnu/gnu.emacs.help.html
    The FAQ for gnu.emacs.help (at www.faqs.org)]
  [J [L ftp://ftp-mailing-list-archives.gnu.org/]
    (very difficult to connect)]
  [L ftp://gatekeeper.dec.com/pub/GNU/elisp-archive/
    The Emacs Lisp Code Directory (\"LCD\")]
  [J Newsgroups: gnu.emacs.help, comp.emacs. [L search.html Search]
    for (say) \"[TT ~g comp.emacs]\" in dejanews.]

  [L http://www.wcnet.org/jzawodn/emacs/emacs.html
    Emacs Beginner's HOWTO]
  [L http://www.dina.kvl.dk/~abraham/religion/editors-101.html
    Editors 101 - The VI Menace (leaving vi)]
  [L http://www.dina.kvl.dk/~abraham/religion/vi-tutorial.html
    VI Tutorial]
  [L http://www.dina.kvl.dk/~abraham/religion/
    Emacs: The Sacred Editor]
  [L http://www.anc.ed.ac.uk/~stephen/emacs/ellcover.html
    ELL: Emacs Lisp List]

]

}



# (find-vldifile "emacs19.list")
# (find-fline "/usr/doc/emacs19/")
# (find-vldifile "emacs20.list")
# (find-fline "/usr/doc/emacs20/")
# (find-fline "/usr/share/emacs/19.34/etc/FAQ")


# [P [AL .emacs.html .emacs]]
# [P [AL escripts.html e-scripts]]



# [P BTW, I was never able to switch to Emacs20 because I stepped on a
# bug in it that wouldn't let me work with Linux's VCs using cp850 and
# glyphs (I prefer working on text mode, X is slow and somewhat buggy
# on my very cheap video card). [MYL a/glyphbug Here's a copy of the
# bug report I sent (as an e-script)]\; I'm now trying to patch
# Debian's package of Emacs20.3 to 20.4 using the original stuff from
# [LR ftp://prep.ai.mit.edu/pub/gnu/emacs/].]


# [P (The documentation on eev.el is evolving but is still a mess.
# Please start by [L eev-manifesto.html the eev manifesto], then take a
# look at the index of my [L escripts.html escripts repository] or go
# straight to the most interesting e-scripts (oops! You'll have to dig
# them [L hacks.html here]). You may also take a look at [AL eev.el.html
# eev.el itself], at my [AL .emacs.html .emacs], at my [AL .zshrc.html
# .zshrc] or at some [L eev-mails.html old mails I sent about eev.el].
# What comes below is somewhat old and rather technical.)]

# [P Take a look at my [AL eev.el.html eev.el] for a (completely
# obvious?) way to place hyperlinks and shell/tcl/TeX/etc code inside
# text files ([MYL escripts.html e-scripts repository]). I tried to
# document everything there, but the order of the comments may seem
# strange, so here are some direct links to the more important comment
# blocks:]