trackplacer: update some documentation and rename a test file.

This commit is contained in:
Eric S. Raymond 2008-10-15 23:03:27 +00:00
parent f39bc5fc42
commit cba2999bb6
2 changed files with 28 additions and 6 deletions

View File

@ -10,12 +10,23 @@ program; Selecting a file takes you to a main screen. For command help on
the main screen, click the Help button.
Can be started with a map image, in which case we are editing a new journey.
Can be started with a .cfg file. All parts of .cfg files other than the
NEW_* macros placing tracking icons are ignored, except that a comment
of the form "# trackplacer: map=fubar.png" is interpreted as a declaration
that this track has the base map fubar.png (or similarly for any other
fiilrename after the = sign). The NEW_* macros are interpreted snd their
features appended to the track in the order they are given in the file.
Can be started with a .cfg file, in which case iit will look for
track information enclosed in special comments that look like this:
# trackplacer: tracks begin
# trackplacer: tracks end
trackplacer will not alter anything it finds outside these comments,
and will always enclose everything it writes in them.
Special comments may appear in your journey.cfg, looking like this:
# trackplacer: <property>=<value>
These set properties that trackplacer may use. At present there is
only one such property: map, which records the name of the mapfile on
which your track is laid. Do not remove this comment, trackplacer
needs it.
A journey is an object containing a map file name and a (possibly empty)
track. This program exists to visually edit journeys represented in .cfg
@ -404,6 +415,13 @@ class TrackEditor:
tooltips.set_tip(button, "See a help message describing the controls.")
button.show()
# A tracks button
button = gtk.Button("Tracks")
buttonbox.pack_end(button, expand=False, fill=False, padding=10)
button.connect_object("clicked", self.tracks_handler, self.window)
tooltips.set_tip(button, "Select tracks to be displayed.")
button.show()
# A properties button
button = gtk.Button("Properties")
buttonbox.pack_end(button, expand=False, fill=False, padding=10)
@ -703,6 +721,10 @@ class TrackEditor:
w.run()
w.destroy()
def tracks_handler(self, w):
"Modify the visible set of tracks."
pass
def properties_handler(self, w):
"Display a dialog for editing track properties."
w = gtk.Dialog(title="Track properties editor",