procj EEV1 {tag text} { AL [list eev.el $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 (Everything is out of date in this page. Please take my [MYL index.html main page] more seriously than this one, and go straight to the [AL eev/README README] of the current eev package if you want to now how it runs now, what docs and demos the package contains, and whatever else.)] [P If you are new to eev then [IT please] take a look at the [MYL eev-manifesto.html eev Manifesto], and my [MYL tourism.html brief statement about tourism] and at my [MYL index.html main page]\; for more technical things see these [MYL eev-mails.html old descriptions of eev taken from mails I've sent], at [MYL hacks.html the very outdated list of my favorite hacks] or at this [ES latest outdated meta-escript with links to the latest e-script blocks I've written], or at the raw [MYL escripts.html index of my e-scripts repository]...] [P I was trying to write an [MYL emacs-tutor.html emacs tutorial from the eev point of view], but I stopped working on it when it was still very very very far from complete, then I worked a bit on [ES {escripts eev-quick-inst} making the installation easier] and on a [ES {escripts eev-tutorial} quick eev tutorial] (incomplete). Things are still a bit messy, sorry... (new stuff: take a look at [MYL eev-notes.html some material about eev's rough edges])] [P If you want to go straight to the source code, here are some links to the most important comment blocks...] [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 this [AL LATEX/tese2.sty set of macros (tese2.sty)], that I created for my Master's thesis, 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 three 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 I'm planning to document eev.el a lot more, because I want to make it usable by newbies, vi'ers, and many other kinds of people. If you have any question or comment about eev.el (or about glyphs, or e-scripts, or anything related) please [ML eduardoochs@gmail.com mail me]! I need to know where are the main holes in the documentation...] [ANAME glyphs] [H2 Glyphs] [P [BF News, 2000oct22:] [IT all my code to do glyphs has been moved to another file, [AL eev-extras.el]. It used to work only on Linux VTs with hacked codepage 437/850 fonts, but now it works with X too -- with a normal font or with [ES {x font2bdf} the converted version of the hacked font]. But the full support for X is a work in progress and will certainly change a lot in the next few days or weeks, so please don't take it too seriously until it stabilize and I can document it...]] [P [IT Since some months ago the default for [AL eev.el eev.el] has been to work with glyphless e-script files, using \"[RM [TT \#-]]\" and \"[RM [TT %-]]\" as delimiters and \"[RM [TT [Q1 <>]]]\" as anchors. You can change this default either by including a \"Local Variables:\" section at the end of each of your e-script files, or by setting some variables at your .emacs.]] [P [BF News, 2000jan05:] [IT I have managed to [ES {charsets tcs_latin1-850} reorder the chars] in my modified codepage 850 font, producing a font that looks like an enhanced Latin-1 font, and I'm now trying to convert most of my public files to use this new charset.] [BF 2000jan05:] [IT conversion done\; some e-scripts with literal chars in the range 128..255 may need some hand-tuning.]] [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]. ([AL {.emacs glyphs512} Here]'s a link to the glyphs code in my .emacs, as I haven't written any decent docs on it). BTW, the second screenshot below shows how [AL MTA/vtutil vtutil] appears on my screen (modulo the aspect ratio, of course).] [IMAGE IMAGES/emacsllded.png (screenshot, 4kB)] [IMAGE 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 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 [MYL 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.lerner.co.il/emacs/] [L http://www.lerner.co.il/emacs/faq.texinfo.gz] [L http://www.gnu.org/software/emacs/emacs.html ] [L http://www.emacs.org/ ] [LR http://beta.emacs.org/ ] [L http://www.splode.com/~friedman/software/emacs-lisp/ ] [L http://www.faqs.org/faqs/by-newsgroup/gnu/gnu.emacs.help.html The FAQ for gnu.emacs.help (at www.faqs.org)] [L ftp://ftp-mailing-list-archives.gnu.org/] [L ftp://ftp-mailing-list-archives.gnu.org/mailing-lists/] [L ftp://ftp-mailing-list-archives.gnu.org/mailing-lists/help-gnu-emacs/] [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.anc.ed.ac.uk/~stephen/emacs/ellcover.html ELL: Emacs Lisp List] [L http://www.elwood.com/alu/table/contents.htm Association of Lisp Users] ] [HLIST1 {Emacs and vi:} [L http://www.dina.kvl.dk/~abraham/religion/ Emacs: The Sacred Editor] [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.cs.vu.nl/~tmgil/vi.html] [L http://news.tucows.com/ext2/99/02/vim.html] [L http://www.vim.org/] [L http://www.vim.org/why.html] [L ftp://alf.uib.no/pub/vi/macros/hanoi.Z] ] [HLIST1 {Other links:} [L ftp://ls6-ftp.cs.uni-dortmund.de/pub/emacs/] [L ftp://ls6-ftp.cs.uni-dortmund.de/pub/emacs/tutorials/tutorials] [L http://www.lib.uchicago.edu/keith/tcl-course/] [L http://www.lib.uchicago.edu/keith/tcl-course/emacs-tutorial.html] [LR http://www.messengers-of-messiah.org/~csebold/emacs/why.phtml] [LR http://www.messengers-of-messiah.org/~csebold/emacs/] [LR http://www.messengers-of-messiah.org/~csebold/emacs/dot.emacs] [LR http://www.sunworld.com/swol-10-1995/swol-10-software.html] [L http://www.cs.indiana.edu/elisp/w3/w3.html] [L http://www.chez.com/emarsden/downloads/] [L http://www.chez.com/emarsden/downloads/pg.el] [L http://www.cslab.vt.edu/manuals/emacs/emacs_toc.html] [L http://www.cs.umd.edu/users/adrian/] [LR ftp://ftp.dina.kvl.dk/pub/Staff/Per.Abrahamsen/war/] ] } # (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 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 [MYL eev-manifesto.html the eev manifesto], then # take a look at the index of my [MYL escripts.html escripts # repository] or go straight to the most interesting e-scripts (oops! # You'll have to dig them [MYL 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 [MYL # 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:]