diff options
Diffstat (limited to 'app/doc/intro.but.in')
| -rw-r--r-- | app/doc/intro.but.in | 161 |
1 files changed, 87 insertions, 74 deletions
diff --git a/app/doc/intro.but.in b/app/doc/intro.but.in index 1a423f0..2a64c51 100644 --- a/app/doc/intro.but.in +++ b/app/doc/intro.but.in @@ -6,7 +6,7 @@ \# Identify XTrackCAD Version, Microsoft Windows software installation package name and Copyright information -\define{XTCVer} Version @XTRKCAD_VERSION@ +\define{XTCVer} Version @XTRKCAD_VERSION@ \define{XTCWinPack} xtrkcad-setup-@XTRKCAD_VERSION@.exe @@ -27,14 +27,10 @@ Copyright 2020, Martin Fischer, Adam Richards and Dave Bullis \IM{Easements}{Easements and Sectional Track} Easements -\IM{Export}{Export to Bitmap}{Export to DXF} Export - \IM{Window Terms}{XTrackCAD Terms} Glossary \IM{Install directory}{Linux Installation}{Microsoft Windows Installation} Installation -\IM{Copying and Distribution}{GNU General Public License} License - \IM{Add Menu}{File Menu}{Edit Menu}{View Menu}{Change Menu}{Draw Menu}{Manage Menu}{Options Menu} Menus \IM{Entering Values}{Keyboard Shortcuts}{Main Window Overview}{Map Window}{Mouse Actions}{Shortcut Keys}{Typographic Conventions} Navigation @@ -43,8 +39,6 @@ Copyright 2020, Martin Fischer, Adam Richards and Dave Bullis \IM{Additional Shortcut Keys}{Hot Bar}{Keyboard Shortcuts}{Main Drawing Canvas}{Mouse Actions}{Shortcut Keys} Shortcut Keys -\IM{Created by Turnout Command}{Easements and Sectional Track} Sectional Track - \# >>>>>>>>>> Manual Begin's Here <<<<<<<<<< \title \e{XTrackCAD} User's Manual @@ -61,7 +55,7 @@ Copyright 2020, Martin Fischer, Adam Richards and Dave Bullis \cfg{html-local-head}{<meta name="AppleTitle" content="org.xtrkcad.help" />} -\e{XTrackCAD} is a CAD (computer-aided design) program for designing Model Railroad layouts. \e{XTrackCAD} supports any scale, has libraries of popular brands of turnouts and sectional track (plus you add your own easily), can automatically use spiral transition curves when joining track and has extensive on-line help and demonstrations. \e{XTrackCAD} lets you manipulate track much like you would with actual flex-track to modify, extend and join tracks and turnouts. Additional features include tunnels, 'post-it' notes, on-screen ruler, parts list, 99 drawing layers, undo/redo commands, bench-work, 'Print to Bitmap', elevations, train simulation and car inventory. +\e{XTrackCAD} is a CAD (computer-aided design) program for designing Model Railroad layouts. \e{XTrackCAD} supports any scale, has libraries of popular brands of turnouts and sectional track (plus you add your own easily), can automatically use spiral transition curves when joining track and has extensive on-line help and demonstrations. \e{XTrackCAD} lets you manipulate track much like you would with actual flex-track to modify, extend and join tracks and turnouts. Additional features include tunnels, 'post-it' notes, on-screen ruler, parts list, 99 drawing layers, undo/redo commands, bench-work, 'Print to Bitmap', elevations, train simulation and car inventory. Using it, you can @@ -89,7 +83,7 @@ Using it, you can \u000 -\b Trace tracks and other objects over a background image of a real-world location map, a scanned trackplan, or other image. +\b Trace tracks and other objects over a background image of a real-world location map, a scanned trackplan, or other image. \u000 @@ -110,17 +104,17 @@ Be sure to visit the project web page for latest news and updates: \W{http://www \f{Easy to use} - \e{XTrackCAD} was designed to operate in a similar way to pencil and paper: You can draw tracks by dragging the mouse, you select and place turnout "templates" anywhere on existing tracks, and you can use fixed radii for initial design. - -But extra capabilities have been added that give more power by using FlexTracks (Cornu) you have tracks that automatically redraw as you drag turnouts around, creating smooth curves, you can zoom in and out, and of course, undo and deleting tracks are easier! + \e{XTrackCAD} was designed to operate in a similar way to pencil and paper: You can draw tracks by dragging the mouse, you select and place turnout "templates" anywhere on existing tracks, and you can use fixed radii for initial design. -You don't have to be an expert CAD user to make the most of \e{XTrackCAD} but the program will ensure that dimensions, radii and angles are accurate. +But extra capabilities have been added that give more power by using Flex-tracks (Cornu) you have tracks that automatically redraw as you drag turnouts around, creating smooth curves, you can zoom in and out, and of course, undo and deleting tracks are easier! + +You don't have to be an expert CAD user to make the most of \e{XTrackCAD} but the program will ensure that dimensions, radii and angles are accurate. You don't have to specify line lengths or angles and just draw. But if you want to be more precise, you can enter precise dimensions both in real-world and scale sizes. -\e{XTrackCAD} is a specialized CAD for railway modelling, it deals with tracks as tracks, not as line segments. Tracks are connected correctly to each other and with endpoints of turnouts and other components. +\e{XTrackCAD} is a specialized CAD for railway modelling, it deals with tracks as tracks, not as line segments. Tracks are connected correctly to each other and with endpoints of turnouts and other components. -As you zoom in, the two rails are drawn and then ties are added. +As you zoom in, the two rails are drawn and then ties are added. \f{Free} @@ -132,33 +126,35 @@ On-line demonstrations show the actual operation of many of the program's featur \f{Packed with features} -\e{XTrackCAD} is designed from the ground up to be a complete tool for many aspects of Model Railroad layout design. +\e{XTrackCAD} is designed from the ground up to be a complete tool for many aspects of Model Railroad layout design. \dt \e{Active UI Prompting} \dd As the mouse moves over the layout objects, a set of different anchors are shown to indicate what is possible in each command with each modifier key if clicked or double clicked at that location. +\u000 + \dt \e{Train Simulation and Car Inventory} \dd Any number of Cars and Locomotives can be placed on your layout to check clearances, siding capacities and track layout. Trains can be animated to simulate operations and switching on your layout. \u000 -\dd The Car Inventory dialog records your cars and locomotives and these can be exported and imported from spreadsheets. +\dd The Car Inventory dialog records your cars and locomotives and these can be exported and imported from spreadsheets. \u000 \dt \e{Track Manipulation} -\dd Track segments can be lengthened or shortened by simple click and drag. Tangents to a curve are created by dragging away from the curve. Tracks are extended by dragging from an Endpoint, creating new straight or curved segments. New tracks can be snapped into place or precisely placed and then Joined. +\dd Track segments can be lengthened or shortened by simple click and drag. Tangents to a curve are created by dragging away from the curve. Tracks are extended by dragging from an Endpoint, creating new straight or curved segments. New tracks can be snapped into place or precisely placed and then Joined. \u000 -\dd Track circles are especially handy for determining overall designs and seeing what will fit in a given area. +\dd Track circles are especially handy for determining overall designs and seeing what will fit in a given area. \u000 -\dd The Cornu flextrack features create dynamically variable tracks that optimise the curvature of tracks to ensure a protypical appearance. They alter as the other tracks are moved just as flextrack will in the 12 inches to the foot world! +\dd The Cornu flex-track features create dynamically variable tracks that optimise the curvature of tracks to ensure a protypical appearance. They alter as the other tracks are moved just as flex-track will in the 12 inches to the foot world! \u000 @@ -166,38 +162,40 @@ On-line demonstrations show the actual operation of many of the program's featur \u000 -\dd The Join command links any two tracks (Straights, Curves, Turnouts or Turntables) with accurate aligned connecting track segments which can be easements including Cornu easements. The connected tracks are trimmed or extended as required. +\dd The Join command links any two tracks (Straights, Curves, Turnouts or Turntables) with accurate aligned connecting track segments which can be easements including Cornu easements. The connected tracks are trimmed or extended as required. \u000 -\dd The Helix Track command computes the number of turns, radius, grade and vertical separation based on your criteria. +\dd The Helix Track command computes the number of turns, radius, grade and vertical separation based on your criteria. \u000 \dd Turntables can be constructed with any radius and can either have fixed or dynamic bay tracks +\u000 + \dt \e{Turnout Select and Placement} -\dd The Turnout Hot Bar contains a scrolling list of Turnouts, Sectional Tracks and Structures available in the current Scale. Simply click on one and click again drop it onto the layout. +\dd The Turnout Hot Bar contains a scrolling list of Turnouts, Sectional Tracks and Structures available in the current Scale. Simply click on one and click again drop it onto the layout. \u000 -\dd As Turnouts are dragged over existing tracks they are automatically aligned. \e{XTrackCAD} searches for any other tracks that align with each of the Turnout's Endpoints, and shows you the number of connections that will be made and the maximum offset as you position the Turnout. -Just adjust the Turnout's position to minimize the offset to ensure the best fit. +\dd As Turnouts are dragged over existing tracks they are automatically aligned. \e{XTrackCAD} searches for any other tracks that align with each of the Turnout's Endpoints, and shows you the number of connections that will be made and the maximum offset as you position the Turnout. +Just adjust the Turnout's position to minimize the offset to ensure the best fit. \u000 -\dd When a turnout is placed, each Endpoint is examined to see if it aligned to an existing track. If so, the track is split to create a perfect connection to the turnout. Placing Turnouts is a 'snap'. +\dd When a turnout is placed, each Endpoint is examined to see if it aligned to an existing track. If so, the track is split to create a perfect connection to the turnout. Placing Turnouts is a 'snap'. \u000 \dt \e{Layers} -\dd Layers are an important feature for manageing the design for layouts of any complexity. Use one layer for the main-line and others for staging tracks, Bench-work or scenery. Multilevel designs can have groups of layers for each level. +\dd Layers are an important feature for manageing the design for layouts of any complexity. Use one layer for the main-line and others for staging tracks, Bench-work or scenery. Multilevel designs can have groups of layers for each level. \u000 -\dd \e{XTrackCAD} allows up to 99 layers layers can have their own button to control visibility. Each layer can have a name which is displayed as the balloon help for the layer button. +\dd \e{XTrackCAD} allows up to 99 layers layers can have their own button to control visibility. Each layer can have a name which is displayed as the balloon help for the layer button. \u000 @@ -205,13 +203,13 @@ Just adjust the Turnout's position to minimize the offset to ensure the best fit \u000 -\dd Tracks and other objects can be colored according to which layer they are in. Also, each layer can be frozen to prevent accidental changes to parts of the layout that are finalized. +\dd Tracks and other objects can be colored according to which layer they are in. Also, each layer can be frozen to prevent accidental changes to parts of the layout that are finalized. \u000 \dt \e{Elevations and Profile} -\dd Elevations are one of the most powerful features of \e{XTrackCAD} they are dynamically recalulated as the layout changes. +\dd Elevations are one of the most powerful features of \e{XTrackCAD} they are dynamically recalulated as the layout changes. \u000 @@ -219,21 +217,21 @@ Just adjust the Turnout's position to minimize the offset to ensure the best fit \u000 -\dd \e{XTrackCAD} lets you define the elevation of any Endpoint on the layout. You can also have \e{XTrackCAD} automatically compute the elevation and grade between defined elevation points. You can define the elevation at the bottom and top of a sloped track, then have \e{XTrackCAD} compute the elevation at each riser position between. +\dd \e{XTrackCAD} lets you define the elevation of any Endpoint on the layout. You can also have \e{XTrackCAD} automatically compute the elevation and grade between defined elevation points. You can define the elevation at the bottom and top of a sloped track, then have \e{XTrackCAD} compute the elevation at each riser position between. \u000 -\dd Once you have defined a few elevations, you can display the Elevation Profile for the layout along a path of connected track segments. The Profile display shows the length of the track, the elevation of each defined elevation point and the grades between them. You can even adjust the elevations directly on the Profile display. +\dd Once you have defined a few elevations, you can display the Elevation Profile for the layout along a path of connected track segments. The Profile display shows the length of the track, the elevation of each defined elevation point and the grades between them. You can even adjust the elevations directly on the Profile display. \u000 \dt \e{Easements (Cornu Transition Curves)} -\dd Easements are special sections of gradually curving track used to connect straight and curved tracks (or two curved tracks). Easements reduce the effects of sudden changes in track curves which can cause derailments. They also look great! +\dd Easements are special sections of gradually curving track used to connect straight and curved tracks (or two curved tracks). Easements reduce the effects of sudden changes in track curves which can cause derailments. They also look great! \u000 -\dd \e{XTrackCAD} can use Easements anytime the radius of the track changes. The Modify and Join commands will automatically insert Easement Track segments whenever needed. Each Easement is computed based on the radius of the neighboring tracks. You don't even have to think about it! +\dd \e{XTrackCAD} can use Easements anytime the radius of the track changes. The Modify and Join commands will automatically insert Easement Track segments whenever needed. Each Easement is computed based on the radius of the neighboring tracks. You don't even have to think about it! \u000 @@ -257,51 +255,51 @@ Just adjust the Turnout's position to minimize the offset to ensure the best fit \u000 -\dd The Print command lets you scale the printout from a one page overall view (with the handy Snap-Shot button) right up to full size 1:1. +\dd The Print command lets you scale the printout from a one page overall view (with the handy Snap-Shot button) right up to full size 1:1. \u000 -\dd Multiple page printouts are easy to do. A gird representing each page is drawn over the layout and you can click on the pages you want to print. The gird can be moved and rotated to any position so the orientation of the printout matches your layout. Pages can be printed in Portrait or Landscape format. +\dd Multiple page printouts are easy to do. A gird representing each page is drawn over the layout and you can click on the pages you want to print. The gird can be moved and rotated to any position so the orientation of the printout matches your layout. Pages can be printed in Portrait or Landscape format. \u000 -\dd At 1:1, registration marks can be printed every 3" (or 10cm) to help align different sets of printouts. Also, the roadbed outline can be drawn at a user-specified width to assist cutting the roadbed from sheet material. +\dd At 1:1, registration marks can be printed every 3" (or 10cm) to help align different sets of printouts. Also, the roadbed outline can be drawn at a user-specified width to assist cutting the roadbed from sheet material. \u000 \dt \e{Turnout and Structure Creation} -\dd \e{XTrackCAD} comes with Turnout, Sectional Track and Structure Parameter Files for many brands of tracks and accessories. However, your brand may not supplied. The Turnout Designer dialogs and the Group command make it easy to add your own custom definitions. +\dd \e{XTrackCAD} comes with Turnout, Sectional Track and Structure Parameter Files for many brands of tracks and accessories. However, your brand may not supplied. The Turnout Designer dialogs and the Group command make it easy to add your own custom definitions. \u000 -\dd The Turnout Editor has separate screens for designing Turnouts (Regular, Curved, Wye and 3-way), Crossings, Slip-switch, Crossovers and Sectional Track. In each dialog a few measurements are required to create a new definition. Full size printouts can be made directly from the dialog to check your design. +\dd The Turnout Editor has separate screens for designing Turnouts (Regular, Curved, Wye and 3-way), Crossings, Slip-switch, Crossovers and Sectional Track. In each dialog a few measurements are required to create a new definition. Full size printouts can be made directly from the dialog to check your design. \u000 -\dd The Group command can create Structure definitions from selected tracks, lines and shapes. You can make structures as simple as a rectangle or highly detailed. You can also modify existing designs to add details or make adjustments. +\dd The Group command can create Structure definitions from selected tracks, lines and shapes. You can make structures as simple as a rectangle or highly detailed. You can also modify existing designs to add details or make adjustments. \u000 \dt \e{Lines, Shapes, Table Edges, Text and Notes} -\dd Layout designs are more than track! +\dd Layout designs are more than track! \u000 -\dd The \e{XTrackCAD} Draw command is used to draw lines (straight, curved and circles) and shapes (filled boxes, circles, polylines and polygons). These can be different colors and lines can have different widths. The Polylines and Polygons can have curved sides. These are useful for drawing scenic features (rivers, bridges, mountains). +\dd The \e{XTrackCAD} Draw command is used to draw lines (straight, curved and circles) and shapes (filled boxes, circles, polylines and polygons). These can be different colors and lines can have different widths. The Polylines and Polygons can have curved sides. These are useful for drawing scenic features (rivers, bridges, mountains). \u000 -\dd You can add Bench-work and dimension lines too. +\dd You can add Bench-work and dimension lines too. \u000 -\dd Special types of lines are drawn by the Table Edge command are used to represent the boundary at the edge of the layout. +\dd Special types of lines are drawn by the Table Edge command are used to represent the boundary at the edge of the layout. \u000 -\dd Text can be added to the layout. +\dd Text can be added to the layout. \u000 @@ -311,21 +309,21 @@ Just adjust the Turnout's position to minimize the offset to ensure the best fit \dt \e{Parts and Price Lists} -\dd The Parts List command generates a list of the number of the different types of Turnouts, Sectional Track and Structures selected on the layout. You can select everything or just the areas you are working on. As well, the total length of flex-track (for each track scale/gauge used on the layout) is listed. +\dd The Parts List command generates a list of the number of the different types of Turnouts, Sectional Track and Structures selected on the layout. You can select everything or just the areas you are working on. As well, the total length of flex-track (for each track scale/gauge used on the layout) is listed. \u000 -\dd You can enter the price of each type of Turnout, Sectional Track and Structure, plus the length and price of flex-track. \e{XTrackCAD} will compute the price of each types and the grand total. The total number of flex-track sections is also listed. +\dd You can enter the price of each type of Turnout, Sectional Track and Structure, plus the length and price of flex-track. \e{XTrackCAD} will compute the price of each types and the grand total. The total number of flex-track sections is also listed. \u000 \dt \e{Support for Sectional Track} -\dd Numerous Sectional Track Parameter Files are included with \e{XTrackCAD} (Atlas, Marklin, Peco, ...). The Hot Bar allows easy selection. +\dd Numerous Sectional Track Parameter Files are included with \e{XTrackCAD} (Atlas, Marklin, Peco, ...). The Hot Bar allows easy selection. \u000 -\dd The automatic alignment feature of Turnout and Sectional Track placements makes track pieces just 'snap' together. +\dd The automatic alignment feature of Turnout and Sectional Track placements makes track pieces just 'snap' together. \u000 @@ -469,9 +467,9 @@ Refer to \K{keyFeatures} and \K{addFeatures} for a listing of \e{XTrackCAD} feat \H{addFeatures} Additional \e{XTrackCAD} Features -\e{XTrackCAD} has many other carefully selected features: +\e{XTrackCAD} has many other carefully selected features: -\b Sections of track can be hidden, which can be drawn as dashed lines, or completely hidden. A Tunnel Portal is drawn when a hidden track connects with normal track. +\b Sections of track can be hidden, which can be drawn as dashed lines, or completely hidden. A Tunnel Portal is drawn when a hidden track connects with normal track. \u000 @@ -519,7 +517,7 @@ Refer to \K{keyFeatures} and \K{addFeatures} for a listing of \e{XTrackCAD} feat \u000 -\b You can rescale and flip objects, trim turnouts and create block gaps. +\b You can rescale and flip objects, trim turnouts and create block gaps. \u000 @@ -586,7 +584,7 @@ Throughout this manual the following typographic conventions are used to make fi \lcont{\u000} -\n A program folder named \c{XTrkCad4} will be created during the installation process. The folder contains the program, documentation, parameter and example files. +\n A program folder named \c{XTrkCad} will be created during the installation process. The folder contains the program, documentation, parameter and example files. \rule @@ -594,8 +592,8 @@ Throughout this manual the following typographic conventions are used to make fi \e{XTrackCAD} for OSX is shipped as a package containing an application. -\n Start the installation by opening the package and dragging the contained application into the \e{Applications} folder using the shortcut in the package. -The application includes the program, documentation, parameter and example files within it. +\n Start the installation by opening the package and dragging the contained application into the \e{Applications} folder using the shortcut in the package. +The application includes the program, documentation, parameter and example files within it. \lcont{\u000} @@ -603,7 +601,7 @@ The application includes the program, documentation, parameter and example files \lcont{\u000} -\n \i{OSX Run Security} When the application is first run, it will need to be authorized by OSX. There will be a OSX prompt that asks if it should be opened. And then it will still fail to run. +\n \i{OSX Run Security} When the application is first run, it will need to be authorized by OSX. There will be a OSX prompt that asks if it should be opened. And then it will still fail to run. After opening it for the first time, go to \e{System Preferences>Security & Privacy} and you will see that the app is named as having been blocked. Hit the \e{Run Anyway} button and the program should start. This sequence may be necessary after each OS upgrade. @@ -613,17 +611,17 @@ This sequence may be necessary after each OS upgrade. \S{LinuxInstall} \i{Linux Installation} -\e{XTrackCAD} for LINUX is shipped as a self-extracting archive (executable). - +\e{XTrackCAD} for LINUX is shipped as a self-extracting archive (executable). + \n Installing from the self-extracting archive. \lcont{ -\dd After downloading open a command line then +\dd After downloading open a command line then -\dd \c{./\XTCStgzPack --prefix=/usr/local --exclude-subdir} +\dd \c{./\XTCStgzPack --prefix=/usr/local --exclude-subdir} -\dd This will install the executable in /usr/local/bin. A directory named \c{xtrkcad} will be created in +\dd This will install the executable in /usr/local/bin. A directory named \c{xtrkcad} will be created in /usr/local/share and all files will be unpacked into it. } @@ -636,7 +634,7 @@ If you install \e{XTrackCAD} into another directory, set the \c{XTRKCADLIB} envi The \e{XTrackCAD} executable is named xtrkcad.exe on Windows and xtrkcad on Linux and OSX. -It is usually started by clicking on its icon, or right-click and \f{Open} in OSX Catalina, but there are command line options as well. +It is usually started by clicking on its icon, or right-click and \f{Open} in OSX Catalina, but there are command line options as well. \f{Command Line} @@ -657,19 +655,19 @@ On Linux: \dt \c{c config} -\dd configuration to use. This allows you to have several distinct configurations (eg. +\dd configuration to use. This allows you to have several distinct configurations (eg. parameter files, display options). \u000 \dt \c{layoutfile} -\dd filename for the layout to load. +\dd filename for the layout to load. This parameter takes precedence over the option to resume with the last layout (\K{cmdPref}). \f{Debugging Parameters} -The following parameters are for debugging purposes and are mainly of interest to the +The following parameters are for debugging purposes and are mainly of interest to the developers. \dt \c{v} @@ -681,7 +679,7 @@ developers. \dt \c{d logcontrol} \dd specifies the amount of logging. The argument logcontrol has the format \c{logmodule[=level]}. -logmodule defines the functionality that should be logged, the optional level specifies the loglevel. Zero means no logging. +logmodule defines the functionality that should be logged, the optional level specifies the loglevel. Zero means no logging. Defaults are no modules are logged and loglevel is 1 if omitted from logonctrol parameter. \u000 @@ -690,6 +688,21 @@ Defaults are no modules are logged and loglevel is 1 if omitted from logonctrol \dd set logfile, only needed in conjunction with the debug option. +\u000 + +\dt \c{T} + +\dd Runs all Regression tests (Demos) and exits with 0 if all are successful or with 1 if there any failures. +Regression progress and failures are logged to stdout (Linux and Mac OSX) or xtclog.txt (Windows). + +\u000 + +\dt \c{V} + +\dd Display the xtrkcad version and exit(0). + +\u000 + \H{introQT} Quick Tour \G{png.d/main.png} @@ -739,7 +752,7 @@ Under the Tool Bar is the Hot Bar. This contains defined track and drawing objec The main part of the window is the Drawing Area, this is where the Layout is shown in 2D. The view can be zoomed or panned. The \f{Pan-Zoom} command whise symbol is the crossed arrows allows easiest control, but in \f{Select} command you can pan with the arrow keys and zoom with the trackpad or mousewheel or \f{Ctrl}+"+" or "-" can affect the zoom level. -\rule +\rule At the bottom on the screen are two more areas. The Status Bar contains messages about commands as they are being used, and the Info Bar shows the zoom level and the position of the cursor. @@ -768,7 +781,7 @@ This section lists some things that can improve the performance of \e{XTrackCAD} \H{directories} Files and Directories -Information within this section of the manual identifies installation directory names, file names and directory and file locations. +Information within this section of the manual identifies installation directory names, file names and directory and file locations. \rule @@ -782,15 +795,15 @@ Information within this section of the manual identifies installation directory \b The \e{XTrackCAD Working} directory, which contains configuration and Check Point files. -On MS Windows, the \e{Install} directory is set when you install \e{XTrackCAD}. All data files (parameters, -demos, examples) can be found in the \c{share/xtrkcad} subdirectory underneath the \e{Install} directory. +On MS Windows, the \e{Install} directory is set when you install \e{XTrackCAD}. All data files (parameters, +demos, examples) can be found in the \c{share/xtrkcad} subdirectory underneath the \e{Install} directory. The \e{Working} directory is in your personal profile. On Linux, the \e{Install} directory is usually \c{/usr/local/lib/xtrkcad/}, but you can change this by defining the \c{XTRKCADLIB} environment variable before starting \e{XTrackCAD}. The working directory is \c{\{HOME\}/.xtrkcad/}. On Mac OSX, the \e{Install} directory is the application package, usually located in the \c{/Applications} directory. All the included parameters, demos and examples can be found inside the package under the \c{/Applications/xtrkcad/Contents/Resources/xtrkcad} directory. -The \e{Working} directory is created as \c{.xtrkcad} - a hidden directory - under the active user's directory in \c{/Users} +The \e{Working} directory is created as \c{.xtrkcad} - a hidden directory - under the active user's directory in \c{/Users} Layout files (\c{*.xtc}) and export (\K{cmdExport}) files (\c{*.xti}) can be saved anywhere you wish, as specified in the \f{Save File} and \f{Open File} dialogs. @@ -863,7 +876,7 @@ On MS-Windows only, you can also use the \f{Uninstall} icon in the \e{XTrackCAD} \H{bugs_enhancements} Bugs and Enhancements -This section of the manual describes how and where to report a bug or seek an enhancement. +This section of the manual describes how and where to report a bug or seek an enhancement. \rule @@ -890,7 +903,7 @@ If you encounter an unreported bug please submit detail regarding such to the \f \u000 -\dd The error can be replicated by opening the file named cascade.xtc. Set the magnification at 4:1. Attempting to move the text label named "Granville Island" located at the approximate grid coordinates of x=8", y=4' 5". Selecting the label causes the error to occur. +\dd The error can be replicated by opening the file named cascade.xtc. Set the magnification at 4:1. Attempting to move the text label named "Granville Island" located at the approximate grid coordinates of x=8", y=4' 5". Selecting the label causes the error to occur. \u000 @@ -902,7 +915,7 @@ If you encounter an unreported bug please submit detail regarding such to the \f \f{Please be brief, but don't leave any important details out.} This is a fine line to walk. But there are some general guidelines: -Remember the three basics: what you were doing, what you expected to happen, and what happened. +Remember the three basics: what you were doing, what you expected to happen, and what happened. If you can recreate the problem the \f{Macro>Record} command can be used to record what happened. Try to isolate the problem by creating a minimal layout and recording as few commands as possible. |