diff options
Diffstat (limited to 'app/lib/Readme.txt')
| -rw-r--r-- | app/lib/Readme.txt | 1051 |
1 files changed, 559 insertions, 492 deletions
diff --git a/app/lib/Readme.txt b/app/lib/Readme.txt index e98f6d6..568b2e5 100644 --- a/app/lib/Readme.txt +++ b/app/lib/Readme.txt @@ -1,492 +1,559 @@ -
-
-XTRACKCAD 4.2.4A
-
-
-This file contains installation instructions and up-to-date information
-regarding XTrackCad.
-
-
-Contents
-
-- About XTrackCad
-- License Information
-- New features in this release
-- Installation
-- Upgrading from earlier releases
-- Bugs fixed
-- Building
-- Where to go for support
-
-
-About XTrackCad
-
-XTrackCad is a powerful CAD program for designing Model Railroad
-layouts.
-
-Some highlights:
-
-- Easy to use.
-- Supports any scale.
-- Supplied with parameter libraries for many popular brands of
- turnouts, plus the capability to define your own.
-- Automatic easement (spiral transition) curve calculation.
-- Extensive help files and video-clip demonstration mode.
-
-Availability: XTrkCad Fork is a project for further development of the
-original XTrkCad software. See the project homepage at
-http://www.xtrackcad.org/ for news and current releases.
-
-
-License Information
-
-COPYING:
-
-XTrackCad is copyrighted by Dave Bullis and Martin Fischer and licensed
-as free software under the terms of the GNU General Public License v2
-which you can find in the file COPYING.
-
-
-New features
-
-Version 4.2.4
-
-- All: Parameter file for Minitrains HOe-009-HOn30 Track System
-- All: Improved and new parameter files Kato N and Super O
-- All: Corrected parameter file for Peco HOn30/OO9 track
-- All: New parameter file for Peco HOn3 turnouts
-- All: New and updated parameter files for Z-scale
-- All: added a few more length formats
-- All: added additional zoom and marco zoom steps
-- All: Increase meximum number of layer buttons to 99
-- All: The parameter file dialog now allows loading and unloading
- several files together
-
-Version 4.2.3
-
-- All: updated German translations
-- All: TT Kuehn added items
-- Linux/OSX: New printing system
-- All: tomix-n.xtp Added or Updated multiple items
-- All: Add length format with six decimal places for English units
- (feature wish #33)
-- All: Feature Request #35: add hotkey for switching map window on and
- off
-- All: Make the installation's param directory the default on initial
- run
-- All: several new and updated parameter files
-- All: add Nm gauge and some Nm track parameters
-
-Version 4.2.2
-
-- All: Update German translations
-- All: extended parameter files fato HO and Walthers N structures
-- All: Added and extended parameter files
-- All: Add support for HOf scale/gauge and Busch track parameter files
-- Linux/OSX: Replace file selector dialog with newer file chooser
- dialog
-- All: Make editing of custom track work
-- All: Fix Atlas HO Code 100 parameter file
-- All: new Kato Unitrack N-Scale parameter file
-- All: add measurement units to train speed
-
-Version 4.2.1
-
-- Increase the number of layer buttons to 99
-- All: Update Eishindo T Gauge parameter file
-- All: Paste clipboard content at position of mouse pointer
-- All: Never mark curve centers of turnouts
-- All: Make drawing of center markings (crosshair) an user option
-- add ability to set text color when creating them
-- Windows: Draw and print crosshair to mark the center of an arc
-- Add the ability to change layers of a piece of track in the
- describe box.
-
-Version 4.2.0
-
-- New and updated parameter files and layout examples
-- Apply user preferences for dimensions to elevations
-- Add ability to update color of Text in properties
-- Fix compile problem on FreeBSD
-- Fix Oracle Solaris Studio 12.3 warnings
-- partially completed Brazilian Portuguese translation (57%)
-- Improve German translations
-- Merged webkit help system from Debian
-- Update help CSS to the Wiki's new default look
-
-
-Bugs fixed
-
-Version 4.2.4a
-
-- All: New parameter file for Micro Engineering HOn3 Turnouts
-- Windows: Fix bug 157 Crash on color change when drawing lines
-- All: Updated parameter file for Kato N scale
-- All: Fix build problem with block and switchmotor feature
-
-Version 4.2.4
-
-- Linux/OSX: Correct search order for config files
-- All: Layout control functions are always included
-- Linux/OSX: add a default file extension when none is present on save
-- Linux/OSX: Update package build
-- All: Fix compiler warnings for pointer to in casts on 64 bit systems
-- All: Correct file comments
-- All: Consistent spelling
-- All: Fix definition for Atlas Code 83 3/4" straight track
-
-Version 4.2.3b
-
-- Windows: Fix numeric overflow when reading layouts created on Linux
-- Linux/OSX: Fix crash when closing Train Control window
-- Linux/OSX: Fix crash when closing Change Elevation Window
-- All: new and improved parameter files for Tillig track
-
-Version 4.2.3a
-
-- Windows: Make UI translation work with directory structure of 64 bit
- Windows
-- Linux/OSX: Use defaults for printer and page settings on first run
-
-Version 4.2.3
-
-- All: Fix bug #143: Roco N Turnout 22247
-- All: fix invalid const variable usage
-- Linux/OSX: cairo is required and no longer optional
-- All: Fix bug #137 remove accelerator keys from block and switchmotor
- functions
-- All: Fixed wrapping of messages in status line
-- All: fix parameter files for On30
-- All: fix some compiler warnings
-- All: Fix bug #137 ie. crash on in intial run
-- All: fix possible signed / unsigned char problems
-- Windows: fix some compiler warnings
-
-Version 4.2.2
-
-- All: proper initialization of gauge on initial run
-- All: Added missing Language code header in Finnish and Brazilian
- Portuguese translations
-- Linux/MacOSX Fix for string conversion issues found using
- -Wformat-security default compiler flag on modern Linux distros
-- All: Bugfix: enable changing the layer of drawing elements from
- Describe dialog
-- All: Fix formatting of parts list, use monospace font on Linux and
- OSX
-- All: fix buffer overflow bug on overly long title lines (bug 120)
-- All: Fix memory violation bug on initial run of XTrackCAD
-- All: help and message fixes, load example directories on first start
-- All: Fix cmake backwards compatibility
-- All: Fix Backspace-Handling when field is emptied completly
-- All: Suppress warning from CMake versions 3.0
-- Linux: Additional files needed for Debian packages
-
-Version 4.2.1
-
-- All: Fix problem with blank line in American prototype file
-- All: fix one occurence if undo assert bug
-- All: Fix setting and getting minimum radius in Layout Options dialog
-- Windows: add round() missing in older Visual Studio versions
-- All: Fix locale problem with Export/Import
-- Linux/OSX: fix line width when printing
-- Linux/OSX: Add text rotation to gtk/cairo
-- Windows: Fix text rotation from Describe dialog
-- Fix initial HotBar Text Issue
-- Fix shift-modify abend
-- Fix redraw on Undo and Redo
-- All: fix bug 23 - make line width independent of zoom factor a
- creation time
-- Remove Ruler Text when selecting ruler button
-- Windows: Correct size calculation for radio buttons and checkboxes
-- Fix ghosts after delete
-- Fix modify
-- Fix ghost tracks and text on mac
-- Fix color stack protection bug
-- Windows Fix Bug 108: make sure that the line width is at least 1
-- ALL Fix bug 110: Proper error message on invalid scale in parameter
- file
-- Linux: Add valid ChangeLog to the RPM package
-- fix layerlist
-- Linux: Make RPM package generator work
-- Linux/OSX Draw and print crosshair to mark center of arc
-- ALL: Complete German translation for UI, messages and demos
-- Linux/OSX Fix bug 103: Icons are unreadable
-- Linux/OSX Fix bug 101: Print command fails with path+name > 42 chars
-- fix kato-n parameter file
-- Change the default input to be the same as the default output.
-- Correction to parameter file, Marklin 5119 is a Right not a Left
- turnout
-
-Version 4.2.0
-
-- Fix I18N on Windows
-- Fix bug 48: created invalid XPMs when many colors were used
-- Windows: associate application icon to xtc files
-- Fixed installation problem on Windows 7 when profile directory did
- not exist
-- Add math library libm to link library list.
-- sscanf extra format string parameter removed
-- Changed the font size used to print XtrackCAD in the engineering
- data box.
-- Update in app/README - correct instructions for Mercurial access
-- Fixed bug 3121382 - made menu item and dialog box labeling
- consistent for custom management
-- Fix bug 3310506, 3121372 (partly) - Minimum gauge is persisted,
- gauge is automatically selected in Layout Options
-- Fixed bug 3524218: print scale is shown correctly on print out.
-- Fixed bug 3468014 - build instructions for OSX in README have been
- updated
-- Fixed bug 3535258 - Broken PostScript in German locale
-- Fixed bug 3375218 - Odometer Reads A Multiple Of Locos
-- Fixed MSVC compile problem and added missing function to mswlib
-- Updated doxygen configuration file to doxygen version 1.8.2
-- Added code to properly determine the postscript fonts occurring in
- a document.
-- Fixed the syntax of the Document Structure Comments.
-- Circle line tangent/center were interchanged
-- Fix cairo text drawing bugs by forcing painting with
- frequent redraws.
-- Locale prefix change to conform to FHS (tracker bug 3049900)
-- Internationalization support added for help button text.
-- FIX: replaced hard-coded XTRKCAD_LOCALE_DIR path with 'locale' based
- on application library directory (XTRKCAD_LOCALE_DIR is defined at
- makefiles generation time and does not reflect the place where the
- application is actually installed)
-- FIX: now it should work with CMake-2.8.1
-- Get command line parameter handling correct
-- make load last layout option work
-- Pango version check at compile time
-- Block and Switchmotor updates
-- FIX: "Gauge" translation support
-- FIX: application crash due to a double value used as a "%*" sprintf.
- scenario is "Manage" -> "Parts List..." -> "Price" (checkbox).
-- Bug fix for setting the minimum radius
-- FIX: hotbar redraw too slow under gtk-quartz
-- FIX: linux still crashed due to a cairo context access after its
- drawable destruction
-- FIX: workaround for OSX with GTK-Quartz -> pixmaps are not rendered
- when using the mask; and replaced gtk_pixmap_new deprecated function
- with gtk_image_new_from_pixmap
-- FIX: crash when displaying a non utf8 string in balloon help
-- FIX: warning removed: pointer targets in passing argument 1 of
- 'strcpy' differ in signedness
-- FIX: removed GTK run-time references to /opt/local in root directory
-- FIX: removed remained Xlib dependencies and added gtk configuration
- files when generating the OSX bundle
-- FIX: image in about dialog box was not being displayed
-- FIX: deallocate PangoFontDescription using the right function
-- FIX: EXC_BAD_ACCESS when displaying about dialog
-- ENH: replace the old font select dialog with the GTK standard one,
- and some code cleanup
-- FIX - text in layout and selection were not aligned
-- New 'About' and new icons
-- Add source for new button icons
-- LINUX Desktop File
-- New application icon
-- Improved support for bitmaps
-- New tip of the day icon
-- Enhanced bitmap display control
-- Improve internationalization support, use simple gettext on Win32
-
-
-
-INSTALLATION
-
-
-Windows
-
-XTrackCad has only been tested on Windows 7.
-
-The MS-Windows version of XTrackCad is shipped as a self-extracting/
-self-installing program using the NSIS Installer from Nullsoft Inc.
-
-Using Windows Explorer, locate the directory in which you downloaded or
-copied your new version of XTrackCAD.
-
-Start the installation program by double clicking on the
-[XTRKCAD-SETUP-4.2.4.EXE][] file icon.
-
-Follow the steps in the installation program.
-
-The installation lets you define the directory into which XTrackCAD is
-installed. The directory is created automatically if it doesn't already
-exist.
-
-A program folder named XTrackCAD 4.2.4 will be created during the
-installation process. This folder contains the program, documentation,
-parameter and example files. An existing installation of earlier
-versions of XTrackCad is not overwritten.
-
-A new program group named XTrackCad 4.2.4 will be created in the Start
-menu.
-
-
-Linux
-
-XTrackCAD for LINUX is shipped as a RPM file and a self extracting
-archive. You will need libc6, X11R6, GTK+2.0, webkitgtk.
-
-Installing from the RPM package.
-
-Use your operating system's package manager to install XTrackCAD.
-
-Installing from the self-extracting archive.
-
-After downloading open a command line then
-
- ./xtrkcad-setup-4.2.4.x86_64.sh --prefix=/usr/local --exclude-subdir
-
-This will install the executable in /usr/local/bin. A directory named
-xtrkcad will be created in /usr/local/share and all files will be
-unpacked into it.
-
-If you install XTrackCAD into another directory, set the XTRKCADLIB
-environment variable to point to that directory.
-
-
-
-RELEASE INFO
-
-
-Upgrade Information
-
-The available options for number formats have been extended. Check your
-setting in Options>Preferences
-
-
-
-BUILDING
-
-
-Overview
-
-The following instructions detail building XTrackCAD using CMake. CMake
-is a cross-platform build system, available at http://www.cmake.org,
-that can be used to generate builds for a variety of build tools ranging
-from "make" to Visual Studio and XCode. Using CMake you can build
-XTrackCAD on Windows, GNU/Linux, and Mac OSX using the build tool(s) of
-your choice.
-
-Building XTrackCAD on GNU/Linux
-
-- Obtain the current sources from Mercurial; I assume that they are
- stored locally at "~/src/xtrkcad". Note that the correct URL for
- read-only access to Mercurial is
- http://xtrkcad-fork.hg.sourceforge.net:8000/hgroot/xtrkcad-fork/xtrkcad
-- Create a separate build directory; for these instructions I assume
- that your build directory is "~/build/xtrkcad".
-- Run CMake from the build directory, passing it the path to the
- source directory:
-
- $ cd ~/build/xtrkcad $ ccmake ~/src/xtrkcad
-
-- Press the "c" key to configure the build. After a few moments you
- will see four options to configure: CMAKE_BUILD_TYPE,
- CMAKE_INSTALL_PREFIX, XTRKCAD_USE_GTK, and XTRKCAD_USE_GTK_CAIRO.
-- Use CMAKE_BUILD_TYPE to control the build type. Enter "Debug" for a
- debug build, "Release" for a release build, etc.
-- Use CMAKE_INSTALL_PREFIX to control where the software will be
- installed. For this example, I assume "~/install/xtrkcad".
-- Use XTRKCAD_USE_GETTEXT to add new locales (language translations).
- Choose "OFF" to use XTrackCAD's default language (English). Refer to
- http://www.xtrkcad.org/Wikka/Internationalization for
- additional information.
-- Use XTRKCAD_USE_GTK to control the user-interface back-end. Choose
- "OFF" for Windows, "ON" for all other platforms.
-- Use XTRKCAD_USE_GTK_CAIRO to enable optional high-quality
- antialiased Cairo rendering for the GTK back-end. This option has no
- effect unless you are using the GTK back-end.
-- Use XTRKCAD_USE_DOXYGEN to enable the production of type, function,
- etc., documentation from the the source code. Requires doxygen if
- enabled. Enable if and only if you intend to hack on the code.
-- If you made any changes, press the "c" key again to update your
- new configuration.
-- Once everything is configured to your satisfaction, press the "g"
- key to generate makefiles for your build.
-- Compile XTrkCad using your new build:
-
- $ make
-
-- Install the new binary:
-
- $ make install
-
-- Run the installed binary:
-
- $ ~/install/xtrkcad/bin/xtrkcad
-
-- If XTRKCAD_USE_DOXYGEN was enabled:
-
- $ make docs-doxygen
-
-to create the internals documentation. Read this documentation by
-pointing your web browser at
-~/build/xtrkcad/docs/doxygen/html/index.html.
-
-Building XTrackCAD on Mac OSX
-
-- You will need to install the following dependencies - I recommend
- using http://www.macports.org to obtain them:
-- GTK2
-- webkit
-- gnome-icon-theme
-- Once the prerequisites are installed the build instructions are the
- same as for the GNU/Linux build, above.
-- Remember that to run XTrackCAD on OSX, you need to have X11 running
- with your DISPLAY set.
-
-Building XTrackCAD on Windows
-
-- Obtain the current sources from Mercurial; I assume that they are
- stored locally at "c:/src/xtrkcad". Note that the correct URL for
- read-only access to Mercurial is
- http://xtrkcad-fork.hg.sourceforge.net:8000/hgroot/xtrkcad-fork/xtrkcad
-- Use the Windows Start menu to run CMake (cmake-gui).
-- Specify the source and build directories in the CMake window. You
- must provide a build directory outside the source tree - I
- use "c:/build/xtrkcad".
-- Press the "Configure" button to configure the build. You will be
- prompted for the type of build to generate. Choose your desired
- tool - I used "Visual Studio 10". After a few moments you will see
- three options to configure: CMAKE_INSTALL_PREFIX, XTRKCAD_USE_GTK,
- and XTRKCAD_USE_GTK_CAIRO.
-- Use CMAKE_INSTALL_PREFIX to control where the software will be
- installed. The default "c:/Program Files/XTrkCAD" is a good choice.
-- Use XTRKCAD_USE_GETTEXT to add new locales (language translations).
- Choose "OFF" to use XTrackCAD's default language (English). Refer to
- http://www.xtrkcad.org/Wikka/Internationalization for
- additional information.
-- Use XTRKCAD_USE_GTK to control the user-interface back-end. Choose
- "OFF" for Windows.
-- Use XTRKCAD_USE_GTK_CAIRO to enable optional high-quality
- antialiased Cairo rendering for the GTK back-end. This option has no
- effect unless on Windows.
-- Use XTRKCAD_USE_DOXYGEN to enable the production of type, function,
- etc., documentation from the the source code. Requires doxygen if
- enabled. Enable if and only if you intend to hack on the code.
-- If you made any changes, press the "Configure" button again to
- update your new configuration.
-- Once everything is configured to your satisfaction, press the "OK"
- button to generate project files for your build.
-- Compile XTrackCad using the new project files. For example, start
- MSVC and open the "XTrkCAD.sln" solution file which is located in
- your build directory.
-- Build the "BUILD_ALL" project to build the software.
-- Build the "INSTALL" project to install the software.
-- Run XTrackCAD by double-clicking its icon located in the install
- directory - for example: c:/Program Files/XTrkCAD/bin/xtrkcad.exe.
-
-
-Where to go for support
-
-The following web addresses will be helpful for any questions or bug
-reports
-
-- The Yahoo!Group mailing list
- http://groups.yahoo.com/projects/XTrkCad
-- The project website for the open source development
- http://www.xtrackcad.org/
-- The official Sourceforge site
- http://www.sourceforge.net/groups/xtrkcad-fork/
-
-Thanks for your interest in XTrackCAD.
+ + +XTRACKCAD 4.3.0 + + +This file contains installation instructions and up-to-date information +regarding XTrackCad. + + +Contents + +- About XTrackCad +- License Information +- New features in this release +- Installation +- Upgrading from earlier releases +- Bugs fixed +- Building +- Where to go for support + + +About XTrackCad + +XTrackCad is a powerful CAD program for designing Model Railroad +layouts. + +Some highlights: + +- Easy to use. +- Supports any scale. +- Supplied with parameter libraries for many popular brands of + turnouts, plus the capability to define your own. +- Automatic easement (spiral transition) curve calculation. +- Extensive help files and video-clip demonstration mode. + +Availability: XTrkCad Fork is a project for further development of the +original XTrkCad software. See the project homepage at +http://www.xtrackcad.org/ for news and current releases. + + +License Information + +COPYING: + +XTrackCad is copyrighted by Dave Bullis and Martin Fischer and licensed +as free software under the terms of the GNU General Public License v2 +which you can find in the file COPYING. + + +New features + +Version 4.3.0 + +- Linux: Install xtrkcad.desktop and xtrkcad.png for desktop + integration +- All: Fix color button initialization +- Add control and sensor types +- Development of signal feature was finished +- Add extra AppleHelp files +- All: Add documentation for layout control elements +- Write proper Describe, Move, and Rotate functions for Signals. +- Add high lighting for signals. +- Add AppleHelp bundle generation including index +- First pass at high lighting layout control elements. +- Linux/OSX: Set directory for rc file +- All: Rework DXF export, add support for metric measurements +- All: Add dynstring to build and modify DynstrMalloc interface +- All: Add dynstring library and unit tests +- All: enable unit testing with CMocka +- Add Layout Control Element management dialog + +Version 4.2.4 + +- All: Parameter file for Minitrains HOe-009-HOn30 Track System +- All: Improved and new parameter files Kato N and Super O +- All: Corrected parameter file for Peco HOn30/OO9 track +- All: New parameter file for Peco HOn3 turnouts +- All: New and updated parameter files for Z-scale +- All: added a few more length formats +- All: added additional zoom and marco zoom steps +- All: Increase meximum number of layer buttons to 99 +- All: The parameter file dialog now allows loading and unloading + several files together + +Version 4.2.3 + +- All: updated German translations +- All: TT Kuehn added items +- Linux/OSX: New printing system +- All: tomix-n.xtp Added or Updated multiple items +- All: Add length format with six decimal places for English units + (feature wish #33) +- All: Feature Request #35: add hotkey for switching map window on and + off +- All: Make the installation's param directory the default on initial + run +- All: several new and updated parameter files +- All: add Nm gauge and some Nm track parameters + +Version 4.2.2 + +- All: Update German translations +- All: extended parameter files fato HO and Walthers N structures +- All: Added and extended parameter files +- All: Add support for HOf scale/gauge and Busch track parameter files +- Linux/OSX: Replace file selector dialog with newer file chooser + dialog +- All: Make editing of custom track work +- All: Fix Atlas HO Code 100 parameter file +- All: new Kato Unitrack N-Scale parameter file +- All: add measurement units to train speed + +Version 4.2.1 + +- Increase the number of layer buttons to 99 +- All: Update Eishindo T Gauge parameter file +- All: Paste clipboard content at position of mouse pointer +- All: Never mark curve centers of turnouts +- All: Make drawing of center markings (crosshair) an user option +- add ability to set text color when creating them +- Windows: Draw and print crosshair to mark the center of an arc +- Add the ability to change layers of a piece of track in the + describe box. + +Version 4.2.0 + +- New and updated parameter files and layout examples +- Apply user preferences for dimensions to elevations +- Add ability to update color of Text in properties +- Fix compile problem on FreeBSD +- Fix Oracle Solaris Studio 12.3 warnings +- partially completed Brazilian Portuguese translation (57%) +- Improve German translations +- Merged webkit help system from Debian +- Update help CSS to the Wiki's new default look + + +Bugs fixed + +Version 4.3.0 + +- All: Save and set user defined values for Text command +- All: Fix path handling error after Save/Save As +- All: Fix color button initialization +- Fix Malloc error (wrong size in ReadBlock, causing Guard1 + hose error) +- Updated cblock.c and cswitchmotor.c to handle possible broken blocks + and switchmotors and not crash (check for NULL pointers) +- Bulletproof against undefined (NULL pointer) track segments in + SwitchMotor code. +- Bulletproof against undefined (NULL pointer) track segments in + Block code. +- Linux/OSX: Preparing for GTK3 migration, second set of changes +- Clean up help files for Apple Help Indexer +- Linux/OSX: Preparing for GTK3 migration, first set of changes +- All: New and updated parameter files for Lego and Peco H0 Code 83 +- Linux/OSX: Add OSX specific files +- Linux/OSX: Split help functions in generic and platform specific + piece +- Description: Correct some translation typos +- Linux/OSX: Fix #163 GCC format-security errors +- All: Update parameter file for Kuehn TT track +- Add forward reference resolution for Blocks and Switchmotors +- Cleanly delete blocks and switch motors when their tracks are + deleted (avoid dangling pointers) +- Updated Spec file +- Expand help path name for longer bundle directories +- Attempt to fix help files crash issue +- Add GLIB Schemas to GTK-Bundle +- All: Improved German translations +- Update Readme for OSX package +- Add support for gtk-mac-bundler +- fix bugs in xtrkcad-bundler code +- Fix parm dialog default for GTK builds +- Add a post-build script for auto-creating OSX images +- Remove failing copy command for gtk-bundle share +- Linux/OSX: Fix uninitialized param file directory on first run +- All: Add TTi scale / gauge +- All: New paramter files for Frateschi HO and Auhagen TTi + +Version 4.2.4a + +- All: Update help +- Linux: Installation from self extracting archive accepts install + path +- Linux/OSX: Remove absolute path from source packages +- All: remove all dependencies on obsolete XTRKCAD_USE_LAYOUTCONTROL + conditional +- All: New parameter file for Micro Engineering HOn3 Turnouts +- Windows: Fix bug 157 Crash on color change when drawing lines +- All: Updated parameter file for Kato N scale +- All: Fix build problem with block and switchmotor feature + +Version 4.2.4 + +- Linux/OSX: Correct search order for config files +- All: Layout control functions are always included +- Linux/OSX: add a default file extension when none is present on save +- Linux/OSX: Update package build +- All: Fix compiler warnings for pointer to in casts on 64 bit systems +- All: Correct file comments +- All: Consistent spelling +- All: Fix definition for Atlas Code 83 3/4" straight track + +Version 4.2.3b + +- Windows: Fix numeric overflow when reading layouts created on Linux +- Linux/OSX: Fix crash when closing Train Control window +- Linux/OSX: Fix crash when closing Change Elevation Window +- All: new and improved parameter files for Tillig track + +Version 4.2.3a + +- Windows: Make UI translation work with directory structure of 64 bit + Windows +- Linux/OSX: Use defaults for printer and page settings on first run + +Version 4.2.3 + +- All: Fix bug #143: Roco N Turnout 22247 +- All: fix invalid const variable usage +- Linux/OSX: cairo is required and no longer optional +- All: Fix bug #137 remove accelerator keys from block and switchmotor + functions +- All: Fixed wrapping of messages in status line +- All: fix parameter files for On30 +- All: fix some compiler warnings +- All: Fix bug #137 ie. crash on in intial run +- All: fix possible signed / unsigned char problems +- Windows: fix some compiler warnings + +Version 4.2.2 + +- All: proper initialization of gauge on initial run +- All: Added missing Language code header in Finnish and Brazilian + Portuguese translations +- Linux/MacOSX Fix for string conversion issues found using + -Wformat-security default compiler flag on modern Linux distros +- All: Bugfix: enable changing the layer of drawing elements from + Describe dialog +- All: Fix formatting of parts list, use monospace font on Linux and + OSX +- All: fix buffer overflow bug on overly long title lines (bug 120) +- All: Fix memory violation bug on initial run of XTrackCAD +- All: help and message fixes, load example directories on first start +- All: Fix cmake backwards compatibility +- All: Fix Backspace-Handling when field is emptied completly +- All: Suppress warning from CMake versions 3.0 +- Linux: Additional files needed for Debian packages + +Version 4.2.1 + +- All: Fix problem with blank line in American prototype file +- All: fix one occurence if undo assert bug +- All: Fix setting and getting minimum radius in Layout Options dialog +- Windows: add round() missing in older Visual Studio versions +- All: Fix locale problem with Export/Import +- Linux/OSX: fix line width when printing +- Linux/OSX: Add text rotation to gtk/cairo +- Windows: Fix text rotation from Describe dialog +- Fix initial HotBar Text Issue +- Fix shift-modify abend +- Fix redraw on Undo and Redo +- All: fix bug 23 - make line width independent of zoom factor a + creation time +- Remove Ruler Text when selecting ruler button +- Windows: Correct size calculation for radio buttons and checkboxes +- Fix ghosts after delete +- Fix modify +- Fix ghost tracks and text on mac +- Fix color stack protection bug +- Windows Fix Bug 108: make sure that the line width is at least 1 +- ALL Fix bug 110: Proper error message on invalid scale in parameter + file +- Linux: Add valid ChangeLog to the RPM package +- fix layerlist +- Linux: Make RPM package generator work +- Linux/OSX Draw and print crosshair to mark center of arc +- ALL: Complete German translation for UI, messages and demos +- Linux/OSX Fix bug 103: Icons are unreadable +- Linux/OSX Fix bug 101: Print command fails with path+name > 42 chars +- fix kato-n parameter file +- Change the default input to be the same as the default output. +- Correction to parameter file, Marklin 5119 is a Right not a Left + turnout + +Version 4.2.0 + +- Fix I18N on Windows +- Fix bug 48: created invalid XPMs when many colors were used +- Windows: associate application icon to xtc files +- Fixed installation problem on Windows 7 when profile directory did + not exist +- Add math library libm to link library list. +- sscanf extra format string parameter removed +- Changed the font size used to print XtrackCAD in the engineering + data box. +- Update in app/README - correct instructions for Mercurial access +- Fixed bug 3121382 - made menu item and dialog box labeling + consistent for custom management +- Fix bug 3310506, 3121372 (partly) - Minimum gauge is persisted, + gauge is automatically selected in Layout Options +- Fixed bug 3524218: print scale is shown correctly on print out. +- Fixed bug 3468014 - build instructions for OSX in README have been + updated +- Fixed bug 3535258 - Broken PostScript in German locale +- Fixed bug 3375218 - Odometer Reads A Multiple Of Locos +- Fixed MSVC compile problem and added missing function to mswlib +- Updated doxygen configuration file to doxygen version 1.8.2 +- Added code to properly determine the postscript fonts occurring in + a document. +- Fixed the syntax of the Document Structure Comments. +- Circle line tangent/center were interchanged +- Fix cairo text drawing bugs by forcing painting with + frequent redraws. +- Locale prefix change to conform to FHS (tracker bug 3049900) +- Internationalization support added for help button text. +- FIX: replaced hard-coded XTRKCAD_LOCALE_DIR path with 'locale' based + on application library directory (XTRKCAD_LOCALE_DIR is defined at + makefiles generation time and does not reflect the place where the + application is actually installed) +- FIX: now it should work with CMake-2.8.1 +- Get command line parameter handling correct +- make load last layout option work +- Pango version check at compile time +- Block and Switchmotor updates +- FIX: "Gauge" translation support +- FIX: application crash due to a double value used as a "%*" sprintf. + scenario is "Manage" -> "Parts List..." -> "Price" (checkbox). +- Bug fix for setting the minimum radius +- FIX: hotbar redraw too slow under gtk-quartz +- FIX: linux still crashed due to a cairo context access after its + drawable destruction +- FIX: workaround for OSX with GTK-Quartz -> pixmaps are not rendered + when using the mask; and replaced gtk_pixmap_new deprecated function + with gtk_image_new_from_pixmap +- FIX: crash when displaying a non utf8 string in balloon help +- FIX: warning removed: pointer targets in passing argument 1 of + 'strcpy' differ in signedness +- FIX: removed GTK run-time references to /opt/local in root directory +- FIX: removed remained Xlib dependencies and added gtk configuration + files when generating the OSX bundle +- FIX: image in about dialog box was not being displayed +- FIX: deallocate PangoFontDescription using the right function +- FIX: EXC_BAD_ACCESS when displaying about dialog +- ENH: replace the old font select dialog with the GTK standard one, + and some code cleanup +- FIX - text in layout and selection were not aligned +- New 'About' and new icons +- Add source for new button icons +- LINUX Desktop File +- New application icon +- Improved support for bitmaps +- New tip of the day icon +- Enhanced bitmap display control +- Improve internationalization support, use simple gettext on Win32 + + + +INSTALLATION + + +Windows + +XTrackCad has only been tested on Windows 7. + +The MS-Windows version of XTrackCad is shipped as a self-extracting/ +self-installing program using the NSIS Installer from Nullsoft Inc. + +Using Windows Explorer, locate the directory in which you downloaded or +copied your new version of XTrackCAD. + +Start the installation program by double clicking on the +[XTRKCAD-SETUP-4.3.0.EXE][] file icon. + +Follow the steps in the installation program. + +The installation lets you define the directory into which XTrackCAD is +installed. The directory is created automatically if it doesn't already +exist. + +A program folder named XTrackCAD 4.3.0 will be created during the +installation process. This folder contains the program, documentation, +parameter and example files. An existing installation of earlier +versions of XTrackCad is not overwritten. + +A new program group named XTrackCad 4.3.0 will be created in the Start +menu. + + +Linux + +XTrackCAD for LINUX is shipped as a RPM file and a self extracting +archive. You will need libc6, X11R6, GTK+2.0, webkitgtk. + +Installing from the RPM package. + +Use your operating system's package manager to install XTrackCAD. + +Installing from the self-extracting archive. + +After downloading open a command line then + + ./xtrkcad-setup-4.3.0.x86_64.sh --prefix=/usr/local --exclude-subdir + +This will install the executable in /usr/local/bin. A directory named +xtrkcad will be created in /usr/local/share and all files will be +unpacked into it. + +If you install XTrackCAD into another directory, set the XTRKCADLIB +environment variable to point to that directory. + + + +RELEASE INFO + + +Upgrade Information + +The available options for number formats have been extended. Check your +setting in Options>Preferences + + + +BUILDING + + +Overview + +The following instructions detail building XTrackCAD using CMake. CMake +is a cross-platform build system, available at http://www.cmake.org, +that can be used to generate builds for a variety of build tools ranging +from "make" to Visual Studio and XCode. Using CMake you can build +XTrackCAD on Windows, GNU/Linux, and Mac OSX using the build tool(s) of +your choice. + +Building XTrackCAD on GNU/Linux + +- Obtain the current sources from Mercurial; I assume that they are + stored locally at "~/src/xtrkcad". Note that the correct URL for + read-only access to Mercurial is + http://xtrkcad-fork.hg.sourceforge.net:8000/hgroot/xtrkcad-fork/xtrkcad +- Create a separate build directory; for these instructions I assume + that your build directory is "~/build/xtrkcad". +- Run CMake from the build directory, passing it the path to the + source directory: + + $ cd ~/build/xtrkcad $ ccmake ~/src/xtrkcad + +- Press the "c" key to configure the build. After a few moments you + will see four options to configure: CMAKE_BUILD_TYPE, + CMAKE_INSTALL_PREFIX, XTRKCAD_USE_GTK, and XTRKCAD_USE_GTK_CAIRO. +- Use CMAKE_BUILD_TYPE to control the build type. Enter "Debug" for a + debug build, "Release" for a release build, etc. +- Use CMAKE_INSTALL_PREFIX to control where the software will be + installed. For this example, I assume "~/install/xtrkcad". +- Use XTRKCAD_USE_GETTEXT to add new locales (language translations). + Choose "OFF" to use XTrackCAD's default language (English). Refer to + http://www.xtrkcad.org/Wikka/Internationalization for + additional information. +- Use XTRKCAD_USE_GTK to control the user-interface back-end. Choose + "OFF" for Windows, "ON" for all other platforms. +- Use XTRKCAD_USE_GTK_CAIRO to enable optional high-quality + antialiased Cairo rendering for the GTK back-end. This option has no + effect unless you are using the GTK back-end. +- Use XTRKCAD_USE_DOXYGEN to enable the production of type, function, + etc., documentation from the the source code. Requires doxygen if + enabled. Enable if and only if you intend to hack on the code. +- If you made any changes, press the "c" key again to update your + new configuration. +- Once everything is configured to your satisfaction, press the "g" + key to generate makefiles for your build. +- Compile XTrkCad using your new build: + + $ make + +- Install the new binary: + + $ make install + +- Run the installed binary: + + $ ~/install/xtrkcad/bin/xtrkcad + +- If XTRKCAD_USE_DOXYGEN was enabled: + + $ make docs-doxygen + +to create the internals documentation. Read this documentation by +pointing your web browser at +~/build/xtrkcad/docs/doxygen/html/index.html. + +Building XTrackCAD on Mac OSX + +- You will need to install the following dependencies - I recommend + using http://www.macports.org to obtain them: +- GTK2 +- webkit +- gnome-icon-theme +- Once the prerequisites are installed the build instructions are the + same as for the GNU/Linux build, above. +- Remember that to run XTrackCAD on OSX, you need to have X11 running + with your DISPLAY set. + +Building XTrackCAD on Windows + +- Obtain the current sources from Mercurial; I assume that they are + stored locally at "c:/src/xtrkcad". Note that the correct URL for + read-only access to Mercurial is + http://xtrkcad-fork.hg.sourceforge.net:8000/hgroot/xtrkcad-fork/xtrkcad +- Use the Windows Start menu to run CMake (cmake-gui). +- Specify the source and build directories in the CMake window. You + must provide a build directory outside the source tree - I + use "c:/build/xtrkcad". +- Press the "Configure" button to configure the build. You will be + prompted for the type of build to generate. Choose your desired + tool - I used "Visual Studio 10". After a few moments you will see + three options to configure: CMAKE_INSTALL_PREFIX, XTRKCAD_USE_GTK, + and XTRKCAD_USE_GTK_CAIRO. +- Use CMAKE_INSTALL_PREFIX to control where the software will be + installed. The default "c:/Program Files/XTrkCAD" is a good choice. +- Use XTRKCAD_USE_GETTEXT to add new locales (language translations). + Choose "OFF" to use XTrackCAD's default language (English). Refer to + http://www.xtrkcad.org/Wikka/Internationalization for + additional information. +- Use XTRKCAD_USE_GTK to control the user-interface back-end. Choose + "OFF" for Windows. +- Use XTRKCAD_USE_GTK_CAIRO to enable optional high-quality + antialiased Cairo rendering for the GTK back-end. This option has no + effect unless on Windows. +- Use XTRKCAD_USE_DOXYGEN to enable the production of type, function, + etc., documentation from the the source code. Requires doxygen if + enabled. Enable if and only if you intend to hack on the code. +- If you made any changes, press the "Configure" button again to + update your new configuration. +- Once everything is configured to your satisfaction, press the "OK" + button to generate project files for your build. +- Compile XTrackCad using the new project files. For example, start + MSVC and open the "XTrkCAD.sln" solution file which is located in + your build directory. +- Build the "BUILD_ALL" project to build the software. +- Build the "INSTALL" project to install the software. +- Run XTrackCAD by double-clicking its icon located in the install + directory - for example: c:/Program Files/XTrkCAD/bin/xtrkcad.exe. + + +Where to go for support + +The following web addresses will be helpful for any questions or bug +reports + +- The Yahoo!Group mailing list + http://groups.yahoo.com/projects/XTrkCad +- The project website for the open source development + http://www.xtrackcad.org/ +- The official Sourceforge site + http://www.sourceforge.net/groups/xtrkcad-fork/ + +Thanks for your interest in XTrackCAD. |