LDMakeList: Difference between revisions

From LDraw.org Wiki
Jump to navigation Jump to search
m (Updated infobox details)
m (Updated infobox details)
Line 1: Line 1:
{{Software
{{Software
|image=CMD icon.png
|logo            = CMD icon.png
|developer=[[Meet Tim Gould|Tim Gould]]
|developer       = [[Meet Tim Gould|Tim Gould]]
|function=Library utility
|version         = 2.14 {{comment|2013-10-06}}
|version=2.14 (2013-10-06)
|operating system = Microsoft Windows<br>Mac OS
|status=Unknown
|language        = English
|platform=Microsoft Windows, Mac OS
|genre            = Library utility
|license=GNU GPL
|license         = GNU GPL
|website=[http://code.google.com/p/ldmakelist/ LDMakeList]
|website         = http://code.google.com/p/ldmakelist
}}
}}
'''LDMakeList''' is a tool created by Tim Gould as a replacement for the default '''mklist.exe''' that is included with LDraw.
'''LDMakeList''' is a tool created by Tim Gould as a replacement for the default [[mklist|mklist.exe]] that is currently included with LDraw.
 
It has a number of advantages over mklist.exe, including:


LDMakeList has a number of advantages over mklist.exe, including:
* The ability to disregard parts whose names begin with certain characters, by using the -h command, meaning that colour aliases and other parts that are defined with leading character such as _ or ~ are not listed.
* The ability to disregard parts whose names begin with certain characters, by using the -h command, meaning that colour aliases and other parts that are defined with leading character such as _ or ~ are not listed.
* Different sorting options (eg. -d for description, -n for filename, -p to leave patterns at the end)
* Different sorting options (eg. -d for description, -n for filename, -p to leave patterns at the end)
* The ability to shorten long descriptions to ensure compatibility with older LDraw software
* The ability to shorten long descriptions to ensure compatibility with older LDraw software
==Mac==
Instructions for Mac (NB. you probably require Maverick to run this)
# Save <code>LDMakeList-2.14-Mac.tar</code> ([https://drive.google.com/folderview?id=0B1sfkk_j3usWdEYzNkNaNW5PbjA&usp=sharing|from here]) without changing its filename into your LDraw directory
# Double click on it in <code>Finder</code>, then go into the directory it creates
# Double click on <code>RunLDMakeList</code>, it will run with -d in the parent directory
# If you extract to anywhere else, first copy <code>LDMakeList</code> and <code>RunLDMakeList</code> into your LDraw directory, and then run[1]
'''NB''' Mac power users may also use <code>Terminal.app</code>, then cd into the LDraw directory, then run <code>LDMakeList</code> with any of the command line arguments listed below.
[1] This strips <code>LDMakeList-Mac</code> off the end of the script's directory
if present, and runs there. If not present, it simply runs in the
script's directory.


==Usage==
==Usage==
Line 74: Line 61:


By running the application from the command line, the other switches can also be enabled or disabled.
By running the application from the command line, the other switches can also be enabled or disabled.
==Mac installation==
Instructions for Mac (NB. you probably require Maverick to run this)
# Save <code>LDMakeList-2.14-Mac.tar</code> ([https://drive.google.com/folderview?id=0B1sfkk_j3usWdEYzNkNaNW5PbjA&usp=sharing|from here]) without changing its filename into your LDraw directory
# Double-click on it in <code>Finder</code>, then go into the directory it creates
# Double-click on <code>RunLDMakeList</code>, it will run with -d in the parent directory
# If you extract to anywhere else, first copy <code>LDMakeList</code> and <code>RunLDMakeList</code> into your LDraw directory, and then run[1]
'''NB''' Mac power users may also use <code>Terminal.app</code>, then cd into the LDraw directory, then run <code>LDMakeList</code> with any of the command line arguments listed below.
[1] This strips <code>LDMakeList-Mac</code> off the end of the script's directory
if present, and runs there. If not present, it simply runs in the
script's directory.


==External links==
==External links==

Revision as of 17:11, 17 January 2015

LDMakeList
CMD icon.png
Developer(s) Tim Gould
Initial release unknown
Current version 2.14 (2013-10-06)
Development status unknown
Operating system Microsoft Windows
Mac OS
Available in English
Type Library utility
License GNU GPL
Website http://code.google.com/p/ldmakelist
Software infobox

LDMakeList is a tool created by Tim Gould as a replacement for the default mklist.exe that is currently included with LDraw.

It has a number of advantages over mklist.exe, including:

  • The ability to disregard parts whose names begin with certain characters, by using the -h command, meaning that colour aliases and other parts that are defined with leading character such as _ or ~ are not listed.
  • Different sorting options (eg. -d for description, -n for filename, -p to leave patterns at the end)
  • The ability to shorten long descriptions to ensure compatibility with older LDraw software

Usage

By running the executable file, the following information is supplied:

LDMakeList
Use -? for help, -v for version
Valid options are:
-d or -D : sort by _D_escription (default)
-n or -N : sort by file_N_ame
-p or -P : sort by description (_P_atterns at end of file)
-s or -S : use _S_hort descriptions*
-m or -M : include pri_M_itives in the list
-u or -U : include _U_nofficial part directory
-a or -A : exclude _A_liases from the list
-r or -R : _R_emove duplicate entries (experimental)
-o or -O : Include _o_fficial parts only
-l[DIRNAME] or -L[DIRNAME] : Read from _L_Draw director DIRNAME
-h[C] or -H[C] : -H_ide descriptions starting with character(s) [C]
-i[C] or -I[C] : str_I_p leading character(s) [C] from descriptions
-x or -X : do not write parts._x_ml file

eg. "LDMakeList -d -h=_ -i~" will generate a parts.lst file sorted
by description (-d), excluding colour = and some parts _ (-h=_),
and removing the ~ character (-i~) from the start of descriptions

The -L tag lets you select the base directory for your LDraw
installation (defaults to environment variable LDRAWDIR)
eg. "LDMakeList -d -L." sorts by descriptions in the present
directory

eg. "LDMakeList -u" will look in [LDRAWDIR]/Unofficial/Parts
as well as [LDRAWDIR]/Parts for part files

The -m tag is not recommended for beginner LDraw users

* The old limit for part descriptions is 64 characters and it is
possible that descriptions longer than this might break some
old software. This ensures that the output filenames are no
longer than 64 characters. Use if programs are giving errors.

Sort by [D]escription or [N]umber?

Selecting either D or N will arrange the data in the outputted parts.lst file in a certain order. The option to select D or N will not appear if the option -d or -n or -p is selected.

By running the application from the command line, the other switches can also be enabled or disabled.

Mac installation

Instructions for Mac (NB. you probably require Maverick to run this)

  1. Save LDMakeList-2.14-Mac.tar (here) without changing its filename into your LDraw directory
  2. Double-click on it in Finder, then go into the directory it creates
  3. Double-click on RunLDMakeList, it will run with -d in the parent directory
  4. If you extract to anywhere else, first copy LDMakeList and RunLDMakeList into your LDraw directory, and then run[1]

NB Mac power users may also use Terminal.app, then cd into the LDraw directory, then run LDMakeList with any of the command line arguments listed below.

[1] This strips LDMakeList-Mac off the end of the script's directory if present, and runs there. If not present, it simply runs in the script's directory.

External links