From 16e9630b79f0a7a90c6cedb6781175bb8b337dc1 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?J=C3=B6rg=20Frings-F=C3=BCrst?= Date: Sat, 29 Apr 2017 12:11:08 +0200 Subject: New upstream version 4.3.0 --- app/lib/Readme.txt | 1051 ++++++++++++++++++++++++++++------------------------ 1 file changed, 559 insertions(+), 492 deletions(-) (limited to 'app/lib/Readme.txt') 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 f𲠋ato 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 f𲠋ato 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. -- cgit v1.2.3