╔══════════════════════════════════════════╗
║ ║
║ U S I N G T H E E D I T O R ║
║ ════════════════════════════════════ ║
╚══════════════════════════════════════════╝
┌────────────────────────────────────────┐
│ <shft> F1 = Toggle to regular window │
└────────────────────────────────────────┘
┌──────────────────────────────────────────────────────────────────┐
│ │
│ If you are reading this document for the first time and │
│ are unfamiliar with the commands for scrolling the text, you │
│ should be aware that <ctrl> ▲ (hold down the <ctrl> key and │
│ push the cursor UP key) will scroll the text UP and <ctrl> ▼ │
│ will scroll the text DOWN. You can also use the PageUp and │
│ PageDown keys to scroll quickly through the document. │
│ │
└──────────────────────────────────────────────────────────────────┘
1.1 Dmuse is a multi-tiered program. At the most basic level,
it is a program designed to display and print musical scores and
parts. You may use it for this purpose without knowing about or
using any of its other features.
1.2 The Dmuse program includes a versatile screen editor. At the
most basic level, the screen editor allows you to load and edit
ascii Text files, including .MPG music files. You can use this
editor to modify the musical notation encoded in these files.
1.3 The File icon in the top menu bar (accessed by pressing the
F2 function key) is actually a hold-over from an earlier
version of the interface. All tasks under this icon can actually
be done more quickly and easily using other means. Loading a
file should be done using the Pop-up File Manager; writing a
window to a file can be done with the keystroke <shft> KeyPad +;
clearing a window can be done with two keystrokes:
(1) Home, amd (2) <shft> KeyPad -.
You can call the Pop-up File Manager from the File icon,
or you can simply press F4 .
There should always be an easy way to Quit, and the File
icon gives you one. <ctrl><shft> F2 will do this also.
1.4 Almost all display screens in Dmuse (Pop-up or otherwise)
contain helpful instructions at the bottom (e.g., this screen).
When in doubt, look there first.
1.5 Once a file is loaded into a window, there is an elementry
set of commands that you need to know in order to edit the file:
The cursor keys ◄ ► ▲ ▼ move the
Moving the cursor cursor left and right, up and down.
Holding the <ctrl> key down while
Scrolling the screen pressing the cursor keys ◄ ►
▲ ▼ will scroll text in the window
left and right, up and down.
The PageUp key will scroll text DOWN by
Veiwing text above the number of lines on the screen, thus
displaying a view of the text immediately
ABOVE what you currently see.
The PageDown key will scroll text UP by
Veiwing text below the number of lines on the screen, thus
displaying a view of the text immediately
BELOW what you currently see.
The HOME key will move the cursor to the
Viewing the top first line in the window.
The End key will move the cursor to the
Viewing the bottom last line of text in the window.
1.6 The metaphone for the Dmuse screen editor is a blackboard.
You can put the cursor anywhere you like on this blackboard and
type. To add or change text in a window, simply put the cursor
at the point of the addition/change and type. The Insert key
may be used to toggle between insert mode and over-strike mode.
The Delete key will delete the character immediately above the
cursor. You can insert a blank line by typing <alt> Insert
(hold down <alt> key and press insert). The blank line will
appear above the line the cursor is currently on. You can
delete the line the cursor is on by typing <alt> Delete.
1.7 This concludes the elementry description of the Dmuse editor.
With the commands described above, you can successfully edit any
text in a window. Any additional features described below in this
document and in other documents are designed to make the editing
process easier and more efficient; strickly speaking, they are
not necessary, only useful.
──────────────────────────────────────────────────────────────────
2.1 The Dmuse editor uses the full display of your X-Window.
(You may, of course, resize this at your own pleasure.) The
display provides a partial view of a larger document space we
call a window. A window may contain as many as 98,000 lines
of text. The maximum length of a line is 960 characters.
The editor provides you with 31 windows: 30 windows for working
(numbered 0 to 29) and one HELP WINDOW. You may view only one
window at a time. The KeyPad numbers are used to select the
current window for viewing. The NumLock key must be OFF.
KeyPad 0 to KeyPad 9 will select window 0 to 9 to be
the current window.
<ctrl> KeyPad 0 to <ctrl> KeyPad 9 will select window
10 to 19 to be the current window.
<alt> KeyPad 0 to <alt> KeyPad 9 will select window
20 to 29 to be the current window.
Keypad . will make the previous window the current window.
This command is used to toggle between two windows.
<shft> F1 will toggle between the current window the the
HELP WINDOW. The HELP WINDOW can only be loaded by the
Dmuse Help utility (press F2 , press "h", and select
a help topic).
2.2 Each window is like a blackboard. You can write to the
window simply by putting the cursor where you want, and begin
typing. The text in a window may be scrolled up or down using
the <ctrl> ▲ or <ctrl> ▼ commands. The text may be scrolled
left or right using the <ctrl> ◄ and <ctrl> ► commands. The
two numbers in the top red bar (on the right) tell you which
line the cursor is on and the column the cursor is in.
2.3 Below are discribed eight elementry operations which are
common to all interface editing.
LOAD 1. Load a file to the current window.
If you want to clear a window and load a new file in it,
you must first move the cursor to the top of the window by
by pressing the Home key. If the cursor is not at the top
of the window when you load a file, the lines above the cursor
will not be cleared, and the contents of the window will not
match the contents of the file.
There are two ways to load a file into the current window;
(1) the KeyPad + command, and (2) using the resident file
manager.
KeyPad + = load file to current window. You will be
asked to enter the name of the file you want to load.
If the Dmuse editor thinks that the file you want to load
was not constructed as a text file, it will ask two
questions: Do you want to proceed with loading the file?
And if so, do you want the file displayed in HEX format?
Normally, you would type "N" to the second question.
(!) There may come a time when you really want to see a file
in HEX format. You can force a file to be displayed in
HEX format by typing $ <Enter> at the initial prompt for
a file name.
F4 will activate the resident file manager (this subject
is covered fully in a separate help topic). If you type
l <Enter>, the contents of the current directory will be
listed, with numbers opposite each file name. Find the
number of the file you want to load and enter this number
as the next command. The file manager will load the file
to the current window. If the current directory does
not contain the file you want, you can use file manager
to change to the right directory.
┌───────────────────► Additional Facts ◄────────────────────┐
│ │
│ After a file is loaded into a window, the name of │
│ the file appears in the red title line at the top of │
│ the screen. │
│ │
│ The Dmuse editor allows you to load the listing of │
│ a directory into the current window. Simply push the │
│ KeyPad + as if you were going to load a file and, at │
│ the prompt, enter the name of the directory you want │
│ to load. │
│ │
│ You may also load the current window with the │
│ contents of another Dmuse window using the KeyPad + │
│ command. At the prompt, type an asterisk "*" followed │
│ by the number of the window you want to load. │
│ │
│ If a window is loaded in HEX format, its contents │
│ obviously do not match the source file. To prevent the │
│ window from accidently being copied back to the source │
│ file, the Dmuse editor turns on the read-protect flag │
│ for this window. You will see the word Window in the │
│ top red bar light up in blue. Read-protect can be │
│ turned off again using the <ctrl> F10 command and │
│ selecting the "r" option (toggle read-protect). │
│ │
└───────────────────────────────────────────────────────────┘
SAVE 2. Save the contents of the current window (with changes you
have made) back to the file from which the window was
originally loaded. This is sometimes called "updating a
file."
The procedure for storing the contents of the current
window back to the file from which it originally came is to
type <shft> KeyPad + and, when you are prompted for an output
file name, type "$" <Enter>.
STORE 3. Store the contents of the current window in a file that you
specify.
The command for storing the contents of the current window
in a file is <shft> KeyPad +. You will be prompted for the
output file name. Any valid path name will be accepted.
If the file you specify already exists, you will be asked
if you want to over-write what is currently in that file.
When storing a window into a file, the entire contents of the
window is stored irrespective of the position of the cursor.
┌───────────────────► Additional Facts ◄────────────────────┐
│ │
│ When storing a file, you may specify a file name │
│ that does not currently exist (i.e., a new file name). │
│ The file name may include a sub-directory, provide that │
│ the sub-directory already exists. In other words, the │
│ store command can create a new file name but not a new │
│ sub-directory. If the name is a new, Dmuse will inform │
│ you of this │
│ │
│ When a file is loaded into a window, Dmuse checks │
│ the end-of-line convention to see if the file follows │
│ the Microsoft convention, CR + LF (two bytes), or the │
│ UNIX convention, LF (one byte). The Exempt-CR flag │
│ is set (in the top Red bar) if the file follows the │
│ UNIX convention. When storing a window to a file, │
│ the state of the window's Exempt-CR flag will determine │
│ which convention is used. If the flag is set, all │
│ lines will be terminated with a single LF byte; │
│ otherwise the termination will be with two bytes, │
│ CR + LF (values 13 and 10). │
│ │
│ The Exempt-CR flag for the current window may be │
│ toggled by the user with the <ctrl-shift> KeyPad * │
│ keystroke. (Try this to see the flag displayed.) │
│ │
└───────────────────────────────────────────────────────────┘
CLEAR 4. Clear the current window and put the cursor at the top of
the window.
This action must be accomplished in two steps. The Dmuse
"clear window" command is <shft> KeyPad -. This command will
clear the window from the point of the cursor to the bottom of
the window (i.e. from the position of the cursor to the end of
the current line and all lines below the cursor). To clear
the entire window, you first need to press the Home key, which
will move the move the cursor to line 1, column 1; and then
press <shft> KeyPad -.
DRIVE 5. Change the current disk drive.
Some explanation is required here. One nice feature of
the DOS operating system was that the user could access several
logical disk drives. Starting with the C drive, it was possible
to have drives D:, E:, etc., up to a maximum of drive Z:.
Of course, it was a good idea to leave some drive names open
so that a Zip drive or a CDrom Drive could be mounted.
This system allowed the user to put different kinds of data
on different drives, with each drive having its own current
working directory. This design made it easy to jump back
and forth between different data sets on different drives.
The Linux operating system, by contrast has only one
file system. Every directory and file hangs onto the tree
somewhere. The root of the tree is /. There is only one
current working directory. Switching between data sets
on different branches of the tree can be confusing and
time consuming.
Dmuse has a solution to this problem. In the INIT file
for Dmuse there is a list of virtual disk drives, each of
which represents some node on the file system tree, and
each of which is capable of having its own current working
directory, just like in DOS. The user has the option of
configuring (assigning) these disk names anywhere he/she
chooses. (The command "qq" in the Pop-up File Manager
will show these assignments for your computer.)
You may change the current working drive using the
Pop-up File manager. (What you are really doing in Linux
is changing the one-and-only current working directory.)
This makes it much easier to jump around in the Limux
file system. To access the Pop-up File Manager, press
the F4 key.
RENAME 6. Rename a file in the current directory.
The resident file manager ( F4 ) has a command for this.
ERASE 7. Erase a file from the disk.
The resident file manager ( F4 ) has a command for this.
QUIT 8. Exit the Dmuse program.
The command for exiting Dmuse is <ctrl-shft> F2.
2.4 The Dmuse editor uses most of the IBM PC compatable
characters. Some of the math charcters have been redefined in
order to complete the set of vowels with diacritical marks
(accents, etc.) and to represent other European letters. For
example, there is no way to get an Ê or an Ø with the IBM set.
Also a few of the dingbats (charcters between 1 and 31) have
been redefined. The Dmuse printer driver has been written to
accommodate most of these re-definitions, so your hardcopy
printout will usually match what you see on the screen.
2.5 There are two ways to learn about the keystrokes and the
actions they perform. (1) The Editor quick reference help
subject contains a complete desciption of the keystrokes,
organized by functionality. (2) The Keystrokes help subject
lets you discover the action of each keystroke by actually
typing the keys themselves. The <esc> key returns you to the
editor. You can also activate this utility by pressing <ctrl> F1.
Try this now, just for fun!
──────────────────────────────────────────────────────────────────
3.1 The Dmuse editor allows you to select material (text) from
a window for certain kinds of actions such as insert, delete,
cut, paste, etc. You can use these techniques to move material
from one point in a window to another, or from one window to
another. To take advantage of these features, you need to know
(1) how to select material, and (2) what can be done, once
material has been selected.
3.2 There are three techniques for selecting material: (1) the
box highlight, (2) the line highlight, and (3) the stream
highlight. The box and line highlights work only when wordwrap
is off; the stream highlight works only when wordwrap is on.
The stream highlight will not be discussed in this document.
Keystrokes which produce a highlight
If there is no highlight present, there are three strokes
which can initiate a highlight.
<shft> ◄ = start a box highlight (white) by moving the
cursor to the left
<shft> ► = start a box highlight (white) by moving the
cursor to the right.
<shft> ▼ = start a line highlight (purple) by moving the
cursor down.
Once a box highlight has been intiated, the following strokes
will change its size.
<shft> ▲ <shft> ▼ = move the highlight cursor up or down
one line.
<shft> ◄ <shft> ► = move the highlight cursor left or right
one column.
Once a line highlight has been intiated, the following strokes
will change its size.
<shft> ▲ <shft> ▼ = move the highlight cursor up or down
one line.
<shft> PageUp = move the highlight cursor up 24 lines.
<shft> PageDown = move the highlight cursor down 24 lines.
3.3 If material (text) is highlighted with a box highlight, there
are several things you can do with it.
1. To move highlighted material on the screen, hold down
the ctrl and shft keys and use the cursor arrow keys to
move the highlighted material around. Once this process
has been started, typing any other key will deposit the
highlighted material in its present (new) location. You
need to be aware that the deposited material will write
over anything which is "under" it at the time of deposit.
2. Delete = remove the highlighted material from the
window. Material to the right of the deleted space will
move over (left) to fill that space.
3. <ctrl> Delete = perform the delete operation described
above and also place the deleted material in the "box buffer"
(for possible future "pasting" in some other location)
4. If you have highlighted a column of numbers, you can type
the letter t to get a total. If you have highlighted two,
side-by-side columns of numbers, you can type the letter a
(a for add) to get a third column, which is the sum of the
elements of columns 1 and 2. If you type the letter s (s
for subtract), you will get a third column, which is the
difference of the elements of columns 1 and 2. If your
highlight box extends far enough to the right of column 2
to leave sufficient room for column 3 (the result column),
the numbers in column 3 will be right justified. If your
highlighted numbers contain commas, the answers will have
commas (where appropriate). If your highlighted numbers
have money signs ($, £, ¥, DM), the answers will have
money signs. If you mix your money signs, the arithmetic
operation will not take place.
5. You may change the character attributes (color combinations)
for the characters in a highlighted box by pressing various
compinations of <ctrl> and <shft> with the functions keys
F5 , F6 , F7 , and F8 .
F5 = White on Black
F6 = Black on Red
F7 = Red on Black
F8 = Black on Brick
<ctrl> F5 = Green on Black
<ctrl> F6 = Black on Green
<ctrl> F7 = White on Forest Green
<ctrl> F8 = Black on Purple
<shft> F5 = White on Tan
<shft> F6 = Black on Orange
<shft> F7 = Black on Goldenrod
<shft> F8 = Black on Pink
<ctrl-shft> F5 = White on Blue
<ctrl-shft> F6 = Black on Turquise
<ctrl-shft> F7 = White on Purple
<ctrl-shft> F8 = White on Sea Green
(The colors shown are defaults; they can be changed by
the user. See INIT file under Advanced Topics)
6. The box highlight can be used to draw line patterns.
The line drawing characters are directly accessable from
the keyboard, but using them directly to draw anything but
the most simple patterns can be tedious and time consuming.
It turns out that most of the patterns people want to make
with the line drawing characters can be built up from a
series of boxes and/or lines. You can draw a box pattern
by highlighting the box shape you want and typing either a
minus sign (-) for a single line box or an equal sign (=)
for a double line box. The pattern below was made by
highlighting the box shape on the left and typing "-", and
then highlighting the shape on the right and typing "=".
Typing a tilda "~" after highlighting a box will erase
any line drawing characters around the edge of the box.
┌──────────────────┐
│ │
│ ╔════╪═══════════════╗
│ ║ │ ║
│ ║ │ ║
└─────────────╫────┘ ║
║ ║
╚════════════════════╝
7. <ctrl> Insert will load the material in the box highlight
into the box buffer. Material formerly in the box buffer
will be over written. The contents of the window will
remain unchanged.
3.4 If lines of text are highlighted with a line highlight, there
are two things you can do with the lines.
1. Delete will delete the highlighted lines from the window
and add these lines to the "line buffer" (also called the
line refuse heap).
2. Insert will copy the hightlighted lines from the window
to the line buffer. The contents of the window will stay
unchanged. Lines put into the line buffer as a group can
be taken out of the buffer as a group, provided no new
lines are added in the interum. The line buffer is a
push-down stack of nearly infinite size.
──────────────────────────────────────────────────────────────────
4.1 The Dmuse editor maintains three separate data buffers to
aid in the storage and transfer of text within a window and
between windows: the box buffer, the line buffer, and the
stream buffer. The box buffer is operational only when wordwrap
is off; the stream buffer is operational only when wordwrap is
on. The line buffer is operational all of the time.
4.2 The box buffer stores text data in a rectangular format, i.e.,
the data in the buffer represents a rectangular area with a
specified number of rows and columns. The buffer can hold only
one data pattern at a time, so whenever you put something into
the buffer, whatever was there before is lost.
4.3 To put something in the box buffer, you must first highlight
it with a box highlight. Once material is highlighted, there are
two commands which will load this material into the box buffer.
<ctrl> Insert = copy material in the box highlight to the
box buffer. Contents of the window remains
unchanged.
<ctrl> Delete = copy material in the box highlight to the
box buffer. Delete the highlighted
material from the window. Data to the
right of the highlight shifts left to
fill the empty space.
4.4 The contents of the box buffer may be copied to any window
any number of times. The command to copy the box buffer is
<shft> Insert . The top left-hand corner of the material in
the box buffer will be copied to the window at the point of
the cursor. If insert mode is on, material already at that
point in the window will move to the right to make space for
the buffered material; if insert mode is off, the contents of
the box buffer will overwrite what was in the window at that
point.
4.5 The line buffer differs from the box buffer in two fundamental
ways. Whereas the box buffer can hold only one pattern at a time,
the line buffer can hold virtually an unlimited number of lines.
In fact, the line buffer is actually a line refuse heap; all lines
deleted with various forms of the Delete key end up stored in
the line buffer. Secondly, whereas the contents of the box buffer
cannot be removed, but only overwritten, all of the lines can be
taken out of the line buffer.
4.6 Any lines deleted with a line delete command are automatically
put in the line buffer. Lines can be deleted in two ways:
<alt> Delete will delete the line the cursor is on.
If you push the Delete key after highlighting a group of
lines with the line highlight (purple). The group of lines
will be deleted.
4.7 Lines may be inserted into the line buffer without being
deleted from the window.
<shft-alt> Delete adds the line the cursor is on to the
line buffer without deleting the line from the window.
<shft-alt> ▼ does the same thing, but also scrolls the
screen. This feature allows you to scroll through large
sections of a window, adding lines to the line buffer as
you go.
If you push the Insert key after highlighting a group of
lines with the line highlight (purple). The group of lines
will be added to the line buffer.
4.8 The line buffer is a last-in, first-out buffer. When you
retrieve lines from the buffer, the last line you put in will
come out first. The command that retrieves lines from the
buffer is <shft-alt> Insert. This command normally retrieves
a single line at a time; however, in the case where the last
line put in the buffer was part of a group, the command will
retrieve the entire group. Repeating the command thereafter
will retrieve one line at a time.
4.9 Lines can be retrieved to any line location in any window.
Simply put the cursor on the line where you want lines inserted
and press <shft-alt> Insert.
4.10 When you retrieve lines from the line buffer using the
<shft-alt> Insert command, those lines are taken out of the
buffer. If you want to copy lines from the line buffer to the
screen without taking them out of the buffer, you must use the
<ctrl-shft> Insert command. This command normally copies only
the last line; however, in the case where the last line put in
the buffer was part of a group, the command will copy the
entire group. Repeating the command thereafter will also copy
the entire group.
──────────────────────────────────────────────────────────────────
5.1 The Dmuse editor maintains right and left margins in every
window, irrespective of whether wordwrap is on or off. When
wordwrap is off, the role played by the margins is minimal.
The Enter, <ctrl> Enter, Home, and <ctrl> Home commands will
put the cursor at the left margin.
Enter = move the cursor to left margin and down one line.
<ctrl> Enter = break the line at the cursor; move the right
part to next line, starting at left margin
Home = move the cursor to left margin on line one.
<ctrl> Home = move the cursor to left margin on current line.
With wordwrap off, the right margin is ignored during ordinary
typing. The only commands which recognize the right margin
are the formatting commands: <ctrl> s and <ctrl> p.
<ctrl> s = Reformat the paragraph containing the cursor
into a group of sentences, each starting at
the left margin and observing the right margin.
<ctrl> p = Reformat the group of sentences containing the
cursor into a paragraph within left margin and
the right margin.
The definition of "paragraph" for these commands is a group
of single spaced lines, all beginning (having a non-blank) at
the left margin. The first line of a paragraph may be indented.
5.2 The case where wordwrap is on (Advance Topic) is not
discussed here. Suffice to say that with wordwrap on, the
right margin will force a "soft" carriage return to the left
margin. Moving the margins will cause text within the margins
to be reformatted. The wordwrap feature is useful for typing
documents and for reformatting previously typed text.
5.3 At startup, the left margin is set to the left of column 1,
and the right margin is set at column 76. You may see where the
margins and tabs are set by typing the F10 key (this key
toggles the display panel). The margins may be moved using the
following commands:
left <shft-alt> ◄ = move left margin to the left (◄──).
left <shft-alt> ► = move left margin to the right (──►).
right <shft-alt> ◄ = move right margin to the left (◄──).
right <shft-alt> ► = move right margin to the right (──►).
<ctrl-shft> ◄ = move both margins to the left (◄──).
<ctrl-shft> ► = move both margins to the right (──►).
5.4 Each line in a window has its own setting for the left and
right margin. When moving margins with the commands listed
above, the normal behaviour is for the margins for all lines of
the current paragraph (the paragraph the cursor is in) to move
together. If you want to move the margins for a specific group
of lines, either within a paragraph or spanning more than one
paragraph, the procedure is to create a long (thin) box
highlight spanning the specific group of lines in question, and
then then move the margin. You may also use <ctrl> F10 ,
option "m", to change the default number of paragraphs over
which the margin moving commands operate.
5.5 If you would like to practice moving margins and using the
<ctrl> s and <ctrl> p commands, try out the following commands
on this paragraph. First, press F10 to turn on the margin and
tab display. You will see the location of the right margin as
a line of diamonds (♦); the left margin is hidden at the left.
Place the cursor somewhere in this paragraph and use the left
<shft-alt> ► command to move the left margin up to the left
edge of the paragraph (the blue arrow at the bottom should
point to the position of the first column of characters). Use
the right <shft-alt> ◄ command to move the right margin over
about six columns. Now type <ctrl> s. The paragraph should
"decompose" into a group of sentences. Type <ctrl> p, and the
paragraph should reassemble. Press F10 and try the experiment
again without seeing the margin lines. Notice, by the way,
that the number 5.5 at the left of this paragraph is unaffected
by the reformatting, since it is outside the left margin. Now
see if you can use the left <shft-alt> ◄ and the right
<shft-alt> ► commmands to put the margins back where they
started.
5.6 The Dmuse editor maintains a separate tab configuration for
each window ( F10 will show margins and tabs). A tab can be
set (or removed) by moving the cursor to the desired column and
typing <ctrl> Tab . (left)<ctrl-shft> Tab will clear all tabs.
Typing the Tab key will move the cursor forward to the next
tab on the line or to column 1 of the next line. (left)<shft> Tab
will move the cursor backward to the nearest tab on the line or
to column 1 of the current line, or to the last tab position on
the previous line.
5.7 (right)<shft>Tab works like Tab , but it puts typing in "backup"
mode. You need to try this to fully understand it. Typed
characters appear at the position of the cursor and then move
to the left as more characters are typed. Typing a <space> or
a dot (".") will switch the mode to normal again. The purpose
of this feature is to make it easy to type columns of numbers
with decimals or spaces that line up at the column beyond the
tab. (right)<ctrl-shft>Tab works the same way, but tabs
backwards. Note: The use of <right> and <left> variants of
the control and shift keys is necessary in this application
because the Linux X-Window Manager expropriates the <alt>Tab
combinations for window stacking.
──────────────────────────────────────────────────────────────────
6.1 If your system has a printer connected to the parallel
port (LPT1), you may be able to use the PrintScreen key
to print the contents of a window. The PrintScreen command
will produce a hardcopy printout of the entire contents of
the current window, but several actions must be taken in
order for this command to work.
(1) The Printer must be connected to LPT1, must be on, and
should preferrably be reset, so that settings from any previous
print applications do not interfere with the current job.
(2) Before running the Dmuse program, you must make sure that
you have permission to write to /dev/lp0, the line printer port.
This may be done by switching to superuser and typing
chown 666 /dev/lp0 at the command prompt. Remember to shitch
back to yourself when done.
6.2 As a default, the Dmuse editor will send the following
parameters to the printer:
top line: 5
number of lines: 54
lines per inch: 6 (single space)
left margin: 80 / 100ths of an inch
number of copies: 1
orientation: protrait (8 1/2 wide by 11 inches long)
font: Courier
size: 12 point
You may alter these parameters by pressing F9 and choosing
the "p" option. Follow the instructions to change the various
settings.
──────────────────────────────────────────────────────────────────
7.1 Dmuse provides a method of saving the state of the editor.
Saving the state includes saving the contents of every window
and the settings of most the windows' parameters. Some of the
reasons you might want to save the state of the Dmuse editor
are the following:
(1) to allow the program to be terminated and later be restarted,
without having to go to the trouble of loading every window
again.
(2) to temporarily save the state of things in anticipation
of a power failure (a not uncommon occurance for laptops
running on batteries).
(3) to setup a template for certain kinds of work, e.g., writing
letters or reports.
Important Note: saving the contents of the windows as part of
the state of the editor is not the same as saving each of the
windows in its respective (source) file. A "save state" file
is a binary (non-text) file which can be interpreted by Dmuse
only at startup time. It is a good practice to save all
important windows first in their respective (source) files
before saving the state of the editor.
7.2 The following commands will save the state of Dmuse, either
in a default file or in a file which you specify.
┌──────────► Commands for saving the state of Dmuse ◄──────────┐
│ │
│ Save the current state │
│ Save the current state of Dmuse in a file which │
│ of Dmuse in a default you specify. To return │
│ file. To return to this to this state, type │
│ state, type "dmuse $" "dmuse <file name>" │
│ at the Linux prompt. at the linux prompt. │
│ ┌────────────────────────┬────────────────────────┐ │
│ EXIT │ │ │ │
│ Dmuse │ <shft> F2 │ <ctrl> F2 │ │
│ │ │ │ │
│ ├────────────────────────┼────────────────────────┤ │
│ Do not│ │ │ │
│ EXIT │ <shft> F12 │ <ctrl> F12 │ │
│ Dmuse │ │ │ │
│ └────────────────────────┴────────────────────────┘ │
└──────────────────────────────────────────────────────────────┘
To simply exit Dmuse, type <Ctrl><shft>F2
──────────────────────────────────────────────────────────────────
8.1 The Dmuse editor provides several ways for you to make
large leaps in a window. Two most obvious are Home (goto the
first line in the window) and End (goto the last line in the
window).
8.2 If you want to leap by searching for something, there are
three commands.
KeyPad / = Enter search string and look forward in the
current window for the next occurance of that
string. If an occurance is found, put the
cursor at that location in the window.
F11 = Search forward in the current window for the
next occurance of the search string. If an
occurance is found, put the cursor at that
location in the window.
F12 = Search backward in the current window for a
previous occurance of the search string. If
an occurance is found, put the cursor at that
location in the window.
If you want to search for something that you search for
earlier, type KeyPad / and then ▼ . You wil be given a choice
of up to nine previous search strings.
8.3 The command F3 allows you to leap to a specific line number
in the current window.
──────────────────────────────────────────────────────────────────
9.1 Summary of the keypad keystrokes (with NumLock OFF)
───────────────────────────────────────────────────────
I. The numbers, 0, 1, ... 9
Unmodified: Change to Window number <number>
<ctrl>: Change to Window number <number + 10>
(10, 11, ... 19)
<shft>: Change to Window number <number + 20>
(20, 21, ... 29)
II. KeyPad .
Change to the window previous to the current window.
(This command will work as a toggle between two windows.)
III. KeyPad /
Enter string into search buffer and then look for a match
(search) for this string in the current window, starting
at the position of the cursor and looking forward.
IV. KeyPad *
Unmodified: Toggle Wordwrap mode for this window
(advanced topic)
<shft>: Toggle Connection to Ibex for this window
(advanced topic)
<ctrl-shft>: Toggle Exempt-CR flag
Explanation: Microsoft Windows and Linux have
slightly different conventions for representing
the end of a text line in an ASCII "flat file."
Microsoft uses the character combination carriage-
return + line-feed (byte values 13 and 10); Linux
and UNIX use only the line-feed byte (byte value 10).
The user can expect to encounter both formats.
Since Microsoft formatted files probably outnumber
Linux formatted files, and since all Musedata amd
Score files use the Microsoftformat, this is the
default. However, it is possible for Dmuse to make
an educated guess about the format for each file
loaded into a window. If Dmuse thinks it is loading
a file in the Linux format, the "exempt CR" flag
is set in the top Red bar of the window. It looks
like this in the bar:
connect mode ─┐
exempt CR ─┐ │
↓ ↓
+▒[*] 1446.065
↑ ↑ ↑
insert mode ─┘ │ └─ row number
└─ line number
If the exempt CR flag is set and the contents
of the window are stored in a file, Dmuse will
leave off the CR at the end of each line and
use only the single byte (10) to denote the
end-of-line. <ctrl-shft> KeyPad * allows the
user to toggle this flag and therefore to
control the format of files stored from windows.
V. KeyPad -
Unmodified: Clear line. From the position of the cursor,
clear all text to the right (to end of line).
<shft>: Clear screen. From the position of the cursor,
clear all text to the right (to and of line)
and below (all lines below) the cursor. To
clear the entire screen, use the HOME key to
position the cursor at the top of the screen
and then press <shft> KeyPad -.
VI. KeyPad +
Unmodified: Load a file into the current window. You will
be prompted for the file name. If you respond
with a $ <Enter>, the file you request will be
loaded in HEX representation. The file will be
loaded into the window starting at the current
line (the line the cursor is on).
You may load the current window from another
window using this command. When you are
prompted for the file name, simply type *#,
where # is the number of the window you wish
to load from. # should be in the range 0 to 29.
If the file being loaded is in the Linux format
(single N/L terminator for lines), the Linux
format flag at the top of the window will be
turned on (see <ctrl-shft>KeyPad * above).
Any Tab characters encountered in a line
will be moved right to one position before the
next tab distance, and spaces will be inserted
in the line.
<shft>: Store the entire contents of the current window
in a file. You will be prompted for the output
file name. If you respond with a $ <Enter>, the
output file will be the same as the file from
which the window was last loaded. This name
appears in the red strip at the top of the
screen.
If the Linux format flag at the top of the window
is on when the file is being stored, file records
will be terminated with the single N/L character
rather than the dual CR N/L terminator. Any space
characters (represent either by ascii 32 or
ascii 250, the centered ·) preceding a Tab
character in a line will be removed (up to a
limit of one less than the tab distance).
<ctrl>: Load a file into the current window. This works
just like the Unmodified KeyPad + command, except
that if the file is in Linux format (lines are
terminated with single N/L character), any spaces
added to a line as a result of tab characters will
be represented by the ascii 250 (the centered ·)
character (accessable as <shft><alt> ]), NOT by
ascii 32 (the space character). The Linux format
flag will still be turned on.
<ctrl><shft>: Store the entire contents of the current window
in a file. This works just like the <shft> KeyPad +
command, except that when storing a file in the
Linux format, only space characters represented
by ascii 250 (the centered ·) preceding a Tab
character are removed. Ascii 32 space characters
are not removed.
VII. KeyPad Enter (with various combinations of <ctrl>, <shft> and
<alt>).
These commands will cause Dmuse to look up the word above
the cursor in one of eight possible dictionaries. This
advanced feature is de-activated at the time of the initial
installation of Dmuse. You may read about dictionaries
in the Advance Topics section of the Help menu. The present
version of Dmuse does not include dictionaries, but you
may construct your own.
──────────────────────────────────────────────────────────────────
10.1 For further help in using the editor, try consulting the
Editor quick reference subject heading under the Help menu.
10.2 To learn more about what each keystroke does, try running
the Keystrokes utility under the Help menu. A short cut to
this utility is provided by the <alt> F1 command.
──────────────────────────────────────────────────────────────────