Menu
CTAN
Comprehensive TeX Archive Network
Home Upload Browse

Direc­tory tex-archive/support/xtexshell

Additional help for XTeXShell Version 0.91
------------------------------------------

A manual for XTeXShell is in preparation and will be out soon.  If you have
worked with BORLAND or TURBO C, C++, or Pascal before, you won't have
problems to use XTeXShell. If not, please read the help pages about XTeX from
the main XTeX-window and try what the menu entries and buttons do.


Start XTeXShell with

        xtexsh [filename] [-m mainfilename]

If you specify filename, XTeXShell will automatically start the editor and
load filename. 

The XTeXShell editor hates tabs and replaces them with spaces when loading
a file. This can take a while if you have large files, because a Tcl program
isn't as fast as a compiled program.  In that case, you may wish to convert
your text file before loading it into the editor, for example with the
program TFC.


The following sections are information about features and the way XTeXShell
works, which you probably won't find out by trying.

1) HyperText-Help

From the XTeXShell-Editor, you can get online-help for LaTeX-commands by
   - moving the mouse pointer on the word you want help for and press
     the right mouse button
   - moving the cursor on the word you want help for and press Ctrl-F1
   - Select LaTeX Help Index in the Help menu


2) X-Selection

You can insert the X-Selection in the XTeX-Editor with a double click on
mouse button 2.  This change to the normal X-definition (single click) was
necessary, because Tcl/Tk allows fast scrolling by moving the mouse with
button 2 pressed and I wanted to keep this feature.  See "XTeX-Editor help"
entry in help menu for a detailed explanation of key/mouse functions.

------------------------------------------------------------------------------
*** If you are a novice user, you don't need to read the rest of the document!
------------------------------------------------------------------------------

3) Setup System

During Initialization, XTeXShell reads information and it's default values
from a setup file and a shortcuts file.  Because XTeX was designed for a
multiuser system, the setup system is more complicated than in a single-user
environment:

   - Setup system.  The default variables for XTeXShell are stored in the
     setup files. Initialization is done in 3 steps:

      1) XTeXShell loads the system-wide setup information.  This is either
         the  file "setup.orig" in the XTeXShell root directory, or if exists,
         the file "setup" in the same directory.  Both files must be valid
         Tcl/Tk scripts.

         "setup.orig" is the original setup file and you should *NEVER* change
         it. If you want to modify default values, copy this file to "setup"
         and make your system specific modifications there!

      2) After completing system setup, XTeXShell continues with the user
         setup. If available, it will read the file ~/.xtexsh.setup. Defaults
         for users should go here.  For creating your own ~/.xtexsh.setup file,
         copy the file "setup" from the XTeX root directory.
         An easier way is to use Options/Save options/Save global
         function from the XTeX-Shell which will make the copy automatically
         if no user setup file is present.

      3) Sometimes it is nice to have special default values for a particular
         task.  Therefore the last step of XTeXShell is to try to read the
         file "./.xtexsh.setup" in your current directory. This means that you
         can make the behavior of XTeXShell dependent on the directory where
         you start it.
         If you want to use this feature, copy the file "~/.xtexsh.setup" to
         your current directory.  You can also use the function Options/Save
         Options/Save Options Local, which will automatically make a copy, if
         the file doesn't exist.

   - Shortcuts.  The entries of the Shortcuts-menu and the text which is
     inserted after invoking a shortcut is stored in the shortcuts-files.
     Initialization happens in the same way as the setup-files, but the
     filenames are:

         (XTeXShell-Root)/shortcuts.orig
         (XTeXShell-Root)/shortcuts
         ~/.xtexsh.shortcuts
         ./.xtexsh.shortcuts

-------------------------------------------------------------------------------

3) File formats:

   - Shortcuts: The file format for the shortcuts files is quite simple.

      :entry entry-name
        text
      :endentry

     entry-name will occur in the shortcuts menu and text will be inserted
     to your file after pressing entry-name.  A line with

      :separator

     may be inserted after :endentry which inserts a separation line in the
     shortcuts menu.

   - /help/help: help pages for online hypertext help are stored in this file

        :entry
          entry-name1
          [entry-name2]
          ...
        :header
          text
        :name
          text
        :synopsis
          text
        :description
          text
        :example
          text
        :endentry

        :entry and :endentry are mandatory, everything else is optional.

     text may contain the following formatting commands:

        :ul
        :li text
       [:li text]
        ...
        :eul

        :el
        :li text
       [:li text]
        ...
        :eel

        :dl
        :li definition text
       [:li definition text]
        ...
        :edl

     These environments produce environments similar to the itemize and
     description environments in LaTeX.

        :tt        - select typewriter font
        :em   word - next word italic
        :bold word - next word bold
        :hl   word - next word is a hypertext link. If the user clicks the
                     mouse on this word, the page with the name word will be
                     loaded.  If word ends with a "_", XTeX will read and
                     display the bitmap file "word" in the subdirectory
                     bitmaps.

     After modifying the help file, you will need to run the shell script
     update_help in the help directory

     This shell script will create the file help.index which is the index
     file for the help system.  Each line consists of an entry name and the
     filename and position (in bytes) where the help text for the entry
     starts.


4) Known Bugs

   - The Purge Button doesn't work -- yet

-------------------------------------------------------------------------------

Direc­to­ries

Name Notes
bitmaps
help

Files

Name Size Date Notes
ANNOUNCEMENT 1843 1994-02-23 01:00:00
CHANGELOG 786 1994-02-23 01:00:00
INSTALL 4543 1994-02-23 01:00:00
LICENSE 18446 1994-02-23 01:00:00
README 6457 1994-02-23 01:00:00
XTeXShell-0.91.lsm 1280 1994-02-23 01:00:00
edit.tcl 36951 1994-02-23 01:00:00
exec.tcl 10456 1994-02-22 01:00:00
fileselbox.tcl 7278 1994-02-21 01:00:00
help.tcl 14754 1994-02-22 01:00:00
ldsetup.tcl 5818 1994-02-21 01:00:00
setup.orig 4849 1994-02-23 01:00:00
shortcuts.orig 3087 1994-02-23 01:00:00
tclIndex 3379 1994-02-23 01:00:00
testxtexsh 41 1994-01-22 01:00:00
tfc.cc 18583 1994-02-06 01:00:00
upd 796 1994-02-21 01:00:00
util.tcl 9164 1994-02-23 01:00:00
xtexsh 10235 1994-02-23 01:00:00

Down­load the con­tents of this pack­age in one zip archive (126.9k).

XteXShell – A shell/ed­i­tor

XteXShell is a sys­tem in­de­pen­dent X-Win­dows shell, that means you don't need to care about pro­gram calls, op­er­at­ing sys­tem de­pen­den­cies and other stuff.

XTeXShell is writ­ten in the Tcl/Tk lan­guage with TclX ex­ten­sions.

Doc­u­men­ta­tion
Li­censeGNU Gen­eral Public Li­cense, ver­sion 2
Main­tainerMichael T. Hof­mann
Topics in­te­grated de­vel­op­ment en­vi­ron­ments
Guest Book Sitemap Contact 2014-04-25 06:05 CEST