File: README.html

package info (click to toggle)
etktab 2.5-2
  • links: PTS
  • area: main
  • in suites: woody
  • size: 184 kB
  • ctags: 2
  • sloc: tcl: 2,779; makefile: 30; sh: 15
file content (144 lines) | stat: -rw-r--r-- 6,549 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
<HTML>
<HEAD><TITLE>eTktab README FILE</TITLE></HEAD>
<BODY>
<H2>eTktab</H2>
<P>Author: Jason Sonnenschein
<A HREF=http://etktab.sourceforge.net>Homepage</A>
Email: <A HREF=mailto:jes_jm@yahoo.com>jes_jm@yahoo.com</A></P>
<P>Please read the <A HREF=LICENSE.html>License</A> for this program.</P>

<P>
This program is used to write out guitar tablature in the typical
style of ascii tab, often found around the internet.  The code is based on
TkTab by Giovanni Chierico.  Many of the ideas for the alerations found here
came from emacs tablature mode by Mark R. Rubin.  Guitar icon by Sandy at 
<A HREF=http://www.aroundthepixel.com>Around the Pixel</A>.  Windows and
Mac binaries were created with Tcl/Tk wrapper programs--Drag &amp; Drop Tclets
and Freewrap.</P>

<P>
Some keybindings changed between version 2.1 and 2.5 to make room for new
features.  <B>NOTE:  All keybindings specified in this file are true for 
U.S. keyboard ONLY</B> and are merely here to illustrate how to use the 
program.  Look at eTktab's help window after loading a keybindings file 
appropriate to your keyboard.</P>

<P>
The program will initially run with English and United States keyboard support.
To change the language support or keybindings, do the following:
<OL>
    <LI>Download alternate language and/or keyboard definitions from the eTktab website (or create your own, by editing one of the available files)
    <LI>Place the files in a known place on your system (preferably where eTktab resides)
    <LI>Run eTktab
    <LI>Select the menu entry 'Edit-&gt;Preferences-&gt;Language'
    <LI>Locate the downloaded .etl file on your system
    <LI>Select the menu entry 'Edit-&gt;Preferences-&gt;Keybindings'
    <LI>Locate the downloaded .etk file on your system
</OL></P>

<P>
The 'Save' feature will save files in eTktab's native file format.
This is the only format the program can load.  Use the 'Export' feature
to create a text file of the tablature as it appears on the screen for use
in email, newsgroups, etc.  Exported tablature will only look correct in a 
<B>non-proportional</B> font, such as Courier.</P>

<DL>
<DT><B>VERSION 1 USERS NOTE</B>
<DD>
    The file format changed from version 1 to version 2.  eTktab version
    two will no longer read or write version 1 files.  You can convert
    files with the included script (<TT>fileconvert-v1-to-v2</TT>.)
</DL>

<P>
When eTktab is run without an initial document, it will begin with the 
number of strings in the tablature that you specified in the preferences.  
New windows pulled up via keypress will also have this number of strings.  
Menus allow new documents of any type.
<UL>
  <LI> On <I>Unix</I> machines, an initial file may be loaded by putting the 
       filename on the command line.  
  <LI><I>Macintosh</I> and <I>Windows</I> users can double-click on a document 
         to bring up eTktab with that document.  
</UL></P>

<P>
The note insertion method mimics the ideas of tab mode in emacs.  In 'chord'
mode, the cursor will not advance after a new note is placed, so other notes
of the chord can be put above and below it.  In lead mode, the cursor is 
advanced after each note insertion, and tablature to the right of the cursor is pushed forwards by the newly inserted tab.  The base position for the 'hand' 
may be moved up and down the fretboard with the + and - keys, or the 
base fret menu, then the note is inserted with the following keys:</P>

<P><PRE>
          STRING (guitar)                         STRING (bass)

            E A D G B E                             E A D G
          +-------------+                         +---------+
F  base+0 | 1 2 3 4 5 6 |               F  base+0 | 1 2 3 4 |
R  base+1 | q w e r t y |      OR       R  base+1 | q w e r |
E  base+2 | a s d f g h |               E  base+2 | a s d f |
T  base+3 | z x c v b n |               T  base+3 | z x c v |
</PRE></P>

<P>
So... for example, if the status bar reads that base fret is currently 5,
hitting the 's' key will add to the tab a '7' on the A string.</P>
<P>
Using Shift with the first row of keys play the 'open string' (fret 0,) no
matter what the base fret is currently set to.</P>

<P>
A dialog box can be called up to alter the tuning of the strings in the
tablature by pressing the Tuning button or with the ';' key.</P>

<P>
Note alterations, such as hammer-on and pull-off, may be added and removed
from any note.  All their keybindings are Alt-&lt;something&gt; 
(Option on <I>Macintosh</I>).  Two modifiers are allowed on bar lines... 
they are left repeat and right repeat.  Notes may only have one modifier, 
but bar lines may have both left and right modifiers simultaneously.</P>

<P>
Cutting and pasting via keyboard is done by placing a 'mark' somewhere in 
the tablature, then moving the cursor to the other end of the zone you'd 
like to select.  At that point, you cut or copy the selected tablature, 
move to where you want to paste and paste it.  You may 'unplace' the mark 
with the same key you use to set a mark.  The delete or backspace keys 
will perform a 'clear' if a mark is currently set (cut without adding to 
the paste buffer.)  Otherwise, they have functions related to the current 
position in the tab.</P>
 
<P>
Cut/paste within eTktab will only work between documents of the same
type (same number of strings.)   Tablature pasted into other programs 
(word processors, email, etc.) only looks right in <B>non-proportional</B> 
fonts, such as Courier.</P>

<P>
Mouse bindings:
<UL>
<LI>In the <I>Unix</I> version, clicking the left mouse button moves the cursor.
  Clicking and dragging with the left button highlights an area.  Clicking
  with the right mouse button extends the highlighted area.  Clicking with
  the middle mouse button pastes.
<LI>On <I>Windows and Mac</I>, all that holds true for the left button, above, 
  is true for left button (or the Mac's single button.)  Paste functionality 
  is on the right button.  Extending the highlighted area is done via 
  shift-left button.
</UL>
Note that mouse clicks/drags, etc. need to be within a line of tab.  
Clicks in the blank spaces between lines are ignored.</P>

<P>
An 'undo/redo' feature was added in version 2.0.  It remembers 10 steps.  
Remembering more steps means using more memory.  If you have the source... 
tune as you see fit.</P>

<P>
The rest of the key bindings are explained in the help screen, which
may be called up with the help button at the top of the window, or by hitting
'?' or Control-h (Command-h on <I>Macintosh</I>)</P>
</BODY>
</HTML>