Difference between revisions of "LDMakeList"

From LDraw.org Wiki
Jump to navigation Jump to search
m (Updated infobox details)
m (Minor formatting changes)
Line 3: Line 3:
 
|developer        = [[Meet Tim Gould|Tim Gould]]
 
|developer        = [[Meet Tim Gould|Tim Gould]]
 
|version          = 2.14 {{comment|2013-10-06}}
 
|version          = 2.14 {{comment|2013-10-06}}
|operating system = Microsoft Windows<br>Mac OS
+
|operating system = Microsoft Windows<br>Mac OS X
 
|language        = English
 
|language        = English
 
|genre            = Library utility
 
|genre            = Library utility
 
|license          = GNU GPL
 
|license          = GNU GPL
|website          = http://code.google.com/p/ldmakelist
+
|website          = [http://code.google.com/p/ldmakelist code.google.com/p/ldmakelist]
 
}}
 
}}
'''LDMakeList''' is a tool created by Tim Gould as a replacement for the default [[mklist|mklist.exe]] that is currently included with LDraw.
+
'''{{PAGENAME}}''' is a tool created by Tim Gould as a replacement for the default [[mklist]] that is currently included with [[LDraw]].
  
It has a number of advantages over mklist.exe, including:
+
It has a number of advantages over mklist, 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 {{code|-h}} command, meaning that colour aliases and other parts that are defined with leading character such as {{code|_}} or {{code|~}} are not listed.
* Different sorting options (eg. -d for description, -n for filename, -p to leave patterns at the end)
+
* Different sorting options (eg. {{code|-d}} for description, {{code|-n}} for filename, {{code|-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.
 +
 
 +
LDMakeList is included with the [[LDraw All-In-One Installer]].
  
 
==Usage==
 
==Usage==
By running the executable file, the following information is supplied:
+
<pre style="display:inline-block">LDMakeList
 
 
<pre style="overflow:auto;">LDMakeList
 
 
Use -? for help, -v for version
 
Use -? for help, -v for version
 
Valid options are:
 
Valid options are:
Line 58: Line 58:
 
Sort by [D]escription or [N]umber?</pre>
 
Sort by [D]escription or [N]umber?</pre>
  
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.
+
Selecting either {{code|D}} or {{code|N}} will arrange the data in the outputted {{code|parts.lst}} file in a certain order. The option to select {{code|D}} or {{code|N}} will not appear if the option {{code|-d}} or {{code|-n}} or {{code|-p}} is selected.
  
 
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==
 
==Mac installation==
Instructions for Mac (NB. you probably require Maverick to run this)
+
Instructions for Mac (NB. you probably require [http://en.wikipedia.org/wiki/OS_X_Mavericks OS X Mavericks] to run this)
 +
 
 +
# Save {{code|LDMakeList-2.14-Mac.tar}} ([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}}, then go into the directory it creates.
 +
# Double-click on {{code|RunLDMakeList}}, it will run with {{code|-d}} in the parent directory.
 +
# If you extract to anywhere else, first copy {{code|LDMakeList}} and {{code|RunLDMakeList}} into your LDraw directory, and then run.[1]
  
# 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
+
'''NB''' Mac power users may also use {{code|Terminal.app}}, then {{code|cd}} into the LDraw directory, then run {{code|LDMakeList}} with any of the command line arguments listed above.
# 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}} off the end of the script's directory if present, and runs there. If not present, it simply runs in the script's directory.
  
[1] This strips <code>LDMakeList-Mac</code> off the end of the script's directory
+
==See also==
if present, and runs there. If not present, it simply runs in the
+
* [[makelist]]
script's directory.
+
* [[makelst2]]
 +
* [[mklist]]
  
 
==External links==
 
==External links==
*[http://code.google.com/p/ldmakelist/ LDMakeList] on Google Code Project Hosting
+
* [http://code.google.com/p/ldmakelist/ LDMakeList] on Google Code Project Hosting
 
+
* [https://drive.google.com/folderview?id=0B1sfkk_j3usWdEYzNkNaNW5PbjA&usp=sharing LDMakeList 2.14] on Google Drive
[[Category:Software]]
 

Revision as of 10:23, 22 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 X
Available in English
Type Library utility
License GNU GPL
Website code.google.com/p/ldmakelist
Software infobox

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

It has a number of advantages over mklist, 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.

LDMakeList is included with the LDraw All-In-One Installer.

Usage

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 OS X Mavericks 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 above.

[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.

See also

External links