[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: part combiner questions
From: |
Carter Brey |
Subject: |
Re: part combiner questions |
Date: |
Wed, 17 Jul 2002 00:41:34 -0400 |
User-agent: |
Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.0.0) Gecko/20020606 |
I read the man page for xdvi (BTW, after compiling the source with
--enable-ps-gs I can get beams and slurs; thanks for the tip, guys) ,
and here is what it has to say about point-and-click with editors in
general. Alas, my precooked RH tetex distro seems not to have been
compiled with source specials. Invoking "tex -src-specials" elicits an
"unrecognized option" response. Guess I'll have to bite the bullet,
squeeze tetex source through my 56k modem and recompile. Hope you don't
mind this long cut 'n paste, but many folks have been having
difficulties with this feature.
SOURCE SPECIALS
With properly prepared dvi files, xdvi is capable of call
ing up an editor at the point in the file corresponding to
any given point in the typeset output (``reverse
search''). It can also be invoked so as to move to the
place in the dvi file corresponding to a given line (and,
optionally, column) in a given source file (``forward
search''). Both of these capabilities require that the
version of TeX used to produce the dvi file be compiled to
support ``source specials,'' and that the -src-specials
argument be used on the command line when running TeX.
(Or, some special-purpose macro packages will also suffice
for the above capabilities. In fact, column number infor
mation is not provided by any version of TeX; it must be
provided by a macro package. This is because column in
formation would make the dvi file too large; only special-
purpose applications would benefit from it.)
Reverse Search. Reverse search is done by moving the
mouse to the desired position on the page displayed by xd
vi, and pressing Button 1 while holding the Control button
down.
Each time this feature is used, a new copy of the editor
is invoked. (The editor command can be a program such as
emacsclient, however, which passes the information on to a
running instance of an editor if possible.) The editor is
specified by the -editor command-line option, the .editor
resource, or the XEDITOR, VISUAL, or EDITOR environment
variables; the first of these to specify a value deter
mines the editor to call. If none of these are set, then
the Unix editor vi is used. The value is a string called
as a shell command, in which occurrences of the designator
``%f'' are replaced by the file name, occurrences of
``%l'' are replaced by the line number within the file,
and (if supported) occurrences of ``%c'' are replaced by
the column number within the line. If no designator
``%f'' occurs in the string, then ``+%l %f'' is appended
to the end of the string. If the string was found as the
value of the VISUAL or EDITOR environment variables, then
``xterm -e '' is prepended to the string; if the editor is
specified by other means, then it must be in the form of a
shell command to pop up an X window with an editor in it.
For debugging purposes, Ctrl-Button 2 will draw boxes
around the first glyph or rule in a file occurring on
source lines identified by source specials. In addition,
Ctrl-Button 3 will draw similar boxes around all glyphs
and rules in the file. These boxes are drawn in the color
specified by the highlight color (the -hl command-line op
tion or the .highColor resource). In addition to glyphs
and rules, certain PostScript specials also may be boxed
(those providing a bounding box).
Forward search. Forward search is invoked on the command
line (typically by a text editor), by specifying the
-sourceposition argument. xdvi The main dvi file dvi_file
is specified as usual. ``Forward search'' means that xdvi
will try to open the page in dvi_file corresponding to the
given line number (and, optionally, column number) of the
.tex source file filename, and highlight the place found
by drawing a rectangle in the highlight color (see the -hl
option) around the corresponding text.
In addition, the -sourceposition option causes xdvi to run
in client mode. ``Client mode'' means that if there is
already another instance of xdvi running on this X display
and displaying the same dvi_file, a new instance started
with the -sourceposition option will only notify that run
ning instance to perform the forward search, and exit af
ter that. If no such instance of xdvi is found, then xdvi
will start up a new instance in the background. Either
way, when running in client mode, xdvi will always return
immediately. This is set up so that other programs such
as text editors may invoke xdvi in ``client mode'' to jump
to a specific place in the dvi file corresponding to the
current cursor position in the .tex file, and the user can
continue editing without having to close the xdvi window
first.
The argument for filename should match the file name used
for the source specials in the dvi file. The space before
the filename is optional; it is only needed to avoid ambi
guity if filename starts with a digit or a colon. Note
that the argument needs to be enclosed in quotes if a
space is used, to prevent the shell from misinterpreting
the space as argument separator.
Source specials in the dvi file must have one of the fol
lowing formats:
src:line[ ]filename
src:line:col[ ]filename
src:line
src:line:col
src::col
If filename or line are omitted, the most recent values
are used. The first source special on each page must be
in one of the first two forms, so that defaults are not
inherited across pages.
--
+---------------------------------+
|Carter Brey (address@hidden)|
+---------------------------------+
Homepage:
http://www.nyplive.org/music/orchestra/index.cfm?page=profile&personNum=7
All that glitters is not gold; all that wander are not lost.
12:21am up 4 days, 19:15, 3 users, load average: 0.23, 0.05, 0.02
- part combiner questions, Carter Brey, 2002/07/10
- Re: part combiner questions, Jan Nieuwenhuizen, 2002/07/10
- Re: part combiner questions, Han-Wen Nienhuys, 2002/07/10
- Message not available
- Message not available
- Message not available
- Re: part combiner questions, Han-Wen Nienhuys, 2002/07/16
- Re: part combiner questions,
Carter Brey <=
- Re: part combiner questions, Han-Wen, 2002/07/17
- Re: part combiner questions, Jan Nieuwenhuizen, 2002/07/17
- Re: part combiner questions, Simon Bailey, 2002/07/17
- Re: part combiner questions, Laura Conrad, 2002/07/17
- Re: part combiner questions, Simon Bailey, 2002/07/17
- Re: part combiner questions, Laura Conrad, 2002/07/17