To offer maximum comfort and flexibility to developers, DEScoder provides a complete command line interface.
Thus, all main operations can be run using command line parameters. Both single file encryption and project compilation are available.
In generally, all switches can be specified using - or / indicators, switches are not case-sensitive, and there should be no extra space around the - and / indicators.
Common switches
-keep or /keep
this option forces to keep "intermediate" files after encryption;
during encryption, a number of internal files are created for several compression and encryption stages - normally, these files are deleted automatically;
for troubleshooting, if the encrypted Lisp does not work properly, but the original Lisp file does, those "intermediate" files can be kept for analysis;
normally, Lisp developers will not need to use this option
-nocompress or /nocompress
this option disables "Lisp Code Compression", which is by default active;
before encryption, the Lisp and DCL source file(s) are compressed to remove all unnecessary white-space characters and linefeeds;
for troubleshooting, if the compressed and encrypted Lisp / DCL does not work properly, but the original Lisp / DCL file does, this option can be used to disable compression, to ensure that the final Lisp / DCL code still works;
if such cases are encountered, please send us a sample file as feedback (as this indicates a program error) !
Single File mode
there is no particular command line switch necessary !
any filename provided as command line argument is interpreted as Lisp source file by default; except for filenames using .prv;
filenames using .prv extensions are treated as project definition files;
=> if filename is an existing project filename, the project is compiled, creating target filename as defined by the project;
=> if filename is an existing Lisp file, the Lisp file is encrypted, creating .des filename in same folder as source file.
Wildcards are supported for Single File mode !
you can specify wildcards in usual way to encrypt a set of Lisp source files;
Project mode
-project or /project
this option instructs DEScoder to treat the provided filename as the name of a project definition, regardless of the filename extension;
this option is only necessary, if the project filename is given without .prv extension, or when using an extension other than .prv;
Examples
Single file mode
DEScoder.exe d:\Lisp\Dictionary.lsp
creates encrypted Lisp file d:\Lisp\Dictionary.des
DEScoder.exe d:\Lisp\Dictionary.src
creates encrypted Lisp file d:\Lisp\Dictionary.des
DEScoder.exe d:\Lisp\Dict*.lsp
creates encrypted Lisp files *.des for all Lisp source files matching d:\Lisp\Dict*.lsp pattern
DEScoder.exe -keep d:\Lisp\Dictionary.lsp
creates encrypted Lisp file d:\Lisp\Dictionary.des and keeps intermediate files in same folder d:\Lisp\
Project mode
DEScoder.exe d:\Lisp\Dictionary.prv
compiles the project d:\Lisp\Dictionary.prv and creates the encrypted target file as specified in project
DEScoder.exe /keep d:\Lisp\Dictionary.prv
compiles the project d:\Lisp\Dictionary.prv, creates the encrypted target file as specified in project and keeps intermediate files
DEScoder.exe /project d:\Lisp\Dictionary
compiles the project d:\Lisp\Dictionary.prv and creates the encrypted target file as specified in project;
as .prv filename extension is not specified, the /project option is necessary