JED(1)

πŸ’– JED(1) β€” User Manuals πŸ’–

okay so bestie, you just typed man jed and landed here, and honestly? iconic. this is the User Manuals page for JED, and yeah, it's mostly a lil tutorial β€” the real full docs live in the GNU info files. but everything you need to not be lost? it's all right here. let's go πŸ’…


✨ NAME ✨

Jed</purl> β€” your fave programmers editor. that's it. that's the name. πŸŽ€


🌈 SYNOPSIS 🌈

jed --version
jed-script --version
xjed --version

jed [--secure] [--batch|--script|--help] [options] file ...
jed-script [--secure] script file [script options] ...
xjed [--secure] [X options] [--batch|--script|--help] [options] file ...

look at those three glow-ups: jed, jed-script, and xjed. pick your fighter. 🫢


πŸ¦‹ DESCRIPTION πŸ¦‹

Jed β€” programmers editor. fr fr, that's the whole vibe. πŸ’–

here's the feature list because we do love a resume:

  • Color syntax highlighting ✨
  • Emulation of Emacs, EDT, Wordstar, and Brief editors
  • Extensible in a language that resembles C
  • Completely customizable
  • Editing TeX files with AUC-TeX style editing (BiBTeX support too πŸŽ€)
  • Folding support, and much more...
heads up bestie: for the complete documentation, go read the GNU info files. this manual page is only a brief tutorial. it's giving appetizer, not entrΓ©e. πŸ™ˆ

πŸ‘‘ OPTIONS πŸ‘‘

πŸ’« major options πŸ’«

  • --version β€” prints the version and the compiletime variables. very "who am I, really" of it.
  • --help β€” prints usage information. the classic cry for help, but helpful.
  • --secure β€” runs Jed in secure mode, meaning you literally can't run any external commands with system() or run_shell_cmd(). no cap, the doors are locked. πŸ”’
  • --batch β€” run Jed in batch mode. this is a non-interactive mode, so no chatting back.
  • --script β€” this is a mode like --batch but jed does not eval the startup files. it behaves like slsh. you must give the file that should be evaluated as the second argument. it's the same as calling jed-script.

🌸 minor options 🌸

  • -n β€” do not load the .jedrc file.
  • -a 'file' β€” load file as the user configuration file instead of .jedrc.
  • -e β€” Set emulation mode. the default in Debian is 'emacs'. other valid options are 'vi', 'cua', 'ide'.
  • + 'n' β€” goto line n in the buffer. ⚠️ notice: for this option to take effect it must appear before the file name in the command line, like jed +3 file.
  • -g 'n' β€” goto line n in the buffer. ⚠️ notice: for this option to take effect it must appear after the file name in the command line, like jed file -g 3.
  • -l 'file' β€” load file as S-Lang code.
  • -f 'function' β€” execute the S-Lang function named function.
  • -s 'string' β€” search forward for string.
  • -2 β€” split window. πŸͺŸπŸͺŸ
  • -i 'file' β€” insert file into the current buffer.

🧚 X options 🧚

xjed accepts the common options like -display, -name, -fn and -geometry. and additionally it accepts these lil cuties:

  • -facesize SIZE, -fs SIZE β€” if built with XRENDERFONT support, selects the font size SIZE. use it with the option -fn to select a scalable font.
  • -foreground COLOR, -fg COLOR β€” sets the foreground color.
  • -background COLOR, -bg COLOR β€” sets the background color.
  • -fgMouse COLOR, -mfg COLOR β€” sets the foreground color of the mouse pointer. πŸ–±οΈ
  • -bgMouse COLOR, -mbg COLOR β€” sets the background color of the mouse pointer.
  • -Iconic, -ic β€” start iconified.
  • -title NAME β€” sets the window title to NAME.
for more options, look at xterm.c. iykyk. πŸ’€

πŸŽ€ CONFIGURATION πŸŽ€

🌟 Emulating Other Editors 🌟

JED's ability to create new functions using the S-Lang programming language, plus letting the user choose key bindings, makes emulating other editors possible. currently, JED provides reasonable emulation of the Emacs, EDT, and Wordstar editors. main character energy for all three. πŸ‘‘

πŸ’œ Emacs Emulation πŸ’œ

Emacs Emulation is provided by the S-Lang code in emacs.sl. the basic functionality of Emacs is emulated; most Emacs users should have no problem with JED. to enable Emacs emulation in JED, make sure that the line:

() = evalfile ("emacs");

is in your jed.rc (.jedrc) startup file. JED is distributed with this line already present in the default jed.rc file. so... it's already slaying for you. ✨

πŸ’™ EDT Emulation πŸ’™

for EDT emulation, edt.sl must be loaded. this is accomplished by ensuring that the line:

() = evalfile ("edt");

is present in the jed.rc (.jedrc) Startup File.

πŸ’š Wordstar Emulation πŸ’š

wordstar.sl contains the S-Lang code for JED's Wordstar emulation. adding the line

() = evalfile ("wordstar");

to your jed.rc (.jedrc) startup file will enable JED's Wordstar emulation.


🌈 RUN TIME 🌈

⭐ Status line and Windows ⭐

JED supports multiple windows. each window may contain the same buffer or different buffers. a status line is displayed immediately below each window. the status line contains info like the JED version number, the buffer name, mode, etc.

please beware of the following indicators, bestie, they're telling you things:
  • ** β€” buffer has been modified since last save.
  • %% β€” buffer is read only.
  • m β€” Mark set indicator. this means a region is being defined.
  • d β€” File changed on disk indicator. this indicates that the file associated with the buffer is newer than the buffer itself. πŸ•°οΈ
  • s β€” spot pushed indicator.
  • + β€” Undo is enabled for the buffer.
  • [Narrow] β€” Buffer is narrowed to a region of LINES.
  • [Macro] β€” A macro is being defined.

🫢 Mini-Buffer. 🫢

The Mini-Buffer consists of a single line located at the bottom of the screen. much of the dialog between the user and JED takes place in this buffer. for example, when you search for a string, JED will prompt you for the string in the Mini-Buffer. it's the group chat at the bottom of your screen. πŸ’¬

The Mini-Buffer also provides a direct link to the S-Lang interpreter. to access the interpreter, press Ctrl-X Esc and the S-Lang> prompt will appear in the Mini-Buffer. enter any valid S-Lang expression for evaluation by the interpreter.

It is possible to recall data previously entered into the Mini-Buffer by using the up and down arrow keys. this makes it possible to use and edit previous expressions in a convenient and efficient manner. ⬆️⬇️ obsessed.

🌸 Basic Editing 🌸

Editing with JED is pretty easy β€” most keys simply insert themselves. movement around the buffer is usually done using the arrow keys or page up and page down keys. if edt.sl is loaded, the keypads on VTxxx terminals function as well. here, only the highlights are touched upon (cut/paste operations are not considered `highlights').

in the following, any character prefixed by the ^ character denotes a Control character. on keyboards without an explicit Escape key, Ctrl-[ will most likely generate an Escape character.

a prefix argument to a command may be generated by first hitting the Esc key, then entering the number followed by pressing the desired key. normally, the prefix argument is used simply for repetition. for example, to move to the right 40 characters, one would press Esc 4 0 followed immediately by the right arrow key. this illustrates the use of the repeat argument for repetition. however, the prefix argument may be used in other ways as well. for example, to begin defining a region, one would press the Ctrl-@ key. this sets the mark and begins highlighting. pressing the Ctrl-@ key with a prefix argument will abort the act of defining the region and pop the mark. periodt. πŸ’…

the following list of useful keybindings assumes that emacs.sl has been loaded:

  • Ctrl-L β€” Redraw screen.
  • Ctrl-_ β€” Undo (Control-underscore, also Ctrl-X u').
  • Esc q β€” Reformat paragraph (wrap mode). used with a prefix argument, will justify the paragraph as well.
  • Esc n β€” narrow paragraph (wrap mode). used with a prefix argument will justify the paragraph as well.
  • Esc ; β€” Make Language comment (Fortran and C)
  • Esc \ β€” Trim whitespace around point
  • Esc ! β€” Execute shell command
  • Esc $ β€” Ispell word
  • Ctrl-X ? β€” Show line/column information.
  • ` β€” quoted_insert --- insert next char as is (backquote key)
  • Esc s β€” Center line.
  • Esc u β€” Upcase word.
  • Esc d β€” Downcase word.
  • Esc c β€” Capitalize word.
  • Esc x β€” Get M-x minibuffer prompt with command completion
  • Ctrl-X Ctrl-B β€” pop up a list of buffers
  • Ctrl-X Ctrl-C β€” exit JED
  • Ctrl-X 0 β€” Delete Current Window
  • Ctrl-X 1 β€” One Window.
  • Ctrl-X 2 β€” Split Window.
  • Ctrl-X o β€” Other window.
  • Ctrl-X b β€” switch to buffer
  • Ctrl-X k β€” kill buffer
  • Ctrl-X s β€” save some buffers
  • Ctrl-X Esc β€” Get "S-Lang>" prompt for interface to the S-Lang interpreter.
  • Esc . β€” Find tag
  • Ctrl-@ β€” Set Mark (Begin defining a region). used with a prefix argument aborts the act of defining the region and pops the Mark.

πŸ—‚οΈ FILES πŸ—‚οΈ

  • JED_ROOT/lib/*.sl β€” these are the default runtime jed slang files (packages like jed-extra can define additional slang library directories)
  • JED_ROOT/lib/site.sl β€” This is the default startup file.
  • /etc/jed.d/*.sl β€” The system wide configuration files (this is a special Debian feature).
  • ~/.jedrc β€” Per user configuration file, or
  • ~/.jed/jed.rc β€” per user configuration file if the Jed_Home_Directory ~/.jed/ exists.

πŸ’œ AUTHOR πŸ’œ

John E. Davis <jed@jedsoft.org> Jed's Author. the icon, the blueprint, the moment. πŸ‘‘

--- This document was translated to nroff by "Boris D. Beletsky" <borik@isracom.co.il>


and that's the whole page bestie!! πŸŽ€ this was the Debian edition, from OCT 1996, filed under JED(1) β€” yes, the footer is older than most of the internet and it's still serving. stay iconic, go edit something. πŸ’–βœ¨πŸ¦‹