Don't like reading documentation? Get started quickly by looking at the many examples provided. If you are not familiar with the command line, then please continue reading.
Command Line Examples - General File Comparison
Command Line Examples - Folder Comparison
Command Line Examples - Excel Comparison
'Diff Doc' can be run without a user interface with command line arguments. You can initiate command line execution by going to the operating system's command prompt or from batch files (files with *.BAT extension). A batch file can be created in a simple editor like Notepad.EXE. Once saved, double click the bat file in Windows Explorer to execute it.
Important: If you see the following error or have any other issues:
"DiffDoc is not recognized as an internal or external command, operable program or batch file."
then please read Helpful Hints for Creating a Command Line for further assistance.
Command Line Switches
The syntax for the command line is:
DiffDoc /M{Original File} /S{Modified File} [/I] [/W] [/Q] [/A] [/B] [/E] [/H] [/X] [/Y#] [/Z#] [/1 - 4] [/7 - 9] [/T{ReportFile}] [/R#] [/F#] [/L{Log File}] [/V] [/O] [/D] [/C] [/U] [/K] [/WS#] [/P] [/N]
Items above enclosed in square brackets "[ ]" are optional, all other 'switches' are required. Therefore /M, /S, should always be specified on the command line.
You can include or exclude spaces between switches and parameters. For example, "/R1" is the same as "/R 1". Quotation marks are required for long file names. For example /S"C:\My Data Folder\MyDoc.DOC".
Remember: If you don't specify a particular option in the command line, the option will default to whatever was last set in the user interface.
Full descriptions for each switch are listed below from the most to the least commonly used:
Switch |
Use |
/M{Original File} |
Specify the Original file (to be compared to the modified file). |
/S{Modified File} |
Specify the Modified file (to be compared to the original file). |
/X |
Exit application when done |
/V |
Verbose mode. Use this switch to have pop-up messages show the status of the comparison. Good for troubleshooting. |
/I |
Ignore case when comparing files |
/W |
Ignore whitespace characters (tabs, spaces, etc.) when comparing files |
/E |
Ignore empty lines |
/P |
Remove empty lines |
/N |
Remove formatting |
/B |
Beep when finished doing a file compare |
/Q |
Do a Quick file compare when comparing files. Quick compare only compares the binary file, byte by byte, not the actual content. If there is a binary difference, it is found quickly. |
/L{Log File} |
Specify a log file to log the success or failure of the comparison. |
/WS# |
After comparison is complete, specify the main Window State (0 = Normal, 1 = minimized, 2 = maximized). /X switch should not be used with /WS#. |
|
|
/T{Report File} |
If you are going to create a report file, this switch must be used. The fully qualified path of the report file name should be specified. For example /T"C:\Reports\Output.HTM" NOTE: You may specify Date/Time fields. |
/R# |
Report Format: 1 = HTML (Default) 2 = Text 3 = CSV 4=MS Word. NOTE Only the HTML Format supports the Side By Side view /F2 |
/F# |
Report Style: 1 = All In One 2 = Side by Side (Defaults) NOTE Only the HTML Format supports the Side By Side view /F2 |
/O |
O for Open report when done. Notepad or Internet Explorer is launched depending on the Report type. |
/K |
Do NOT create a report if there were 0 differences found. |
|
|
/Y# |
Excel, Original sheet number to compare. Defaults to 1 |
/Z# |
Excel, Modified sheet number to compare. Defaults to 1 |
/A |
Excel, Compare formulas in Excel files |
/1 |
Excel, Select what rows of the Master file to compare. The syntax is: "1,5-10,20" where commas and dashes indicate single and whole sections of sheets. Use the "*" to compare all rows. Defaults to all. |
/2 |
Excel, Select what columns of the Original file to compare. The syntax is: "1,5-10,20" where commas and dashes indicate single and whole sections of sheets. Use the "*" to compare all columns. Defaults to all. |
/3 |
Excel, Select what rows of the Modified file to compare. The syntax is: "1,5-10,20" where commas and dashes indicate single and whole sections of sheets. Use the "*" to compare all rows. Defaults to all. |
/4 |
Excel, Select what columns of the Modified file to compare. The syntax is: "1,5-10,20" where commas and dashes indicate single and whole sections of sheets. Use the "*" to compare all columns. Defaults to all. |
|
|
/5 |
Report Original File Column Title. Applies only to an HTML-style report. |
/6 |
Report Modified File Column Title. Applies only to an HTML-style report. |
/7 |
Report title. Applies only to an HTML-style report. |
|
|
/8 |
User password. Applies
only to PDF files. |
/9 |
Owner password. Applies
only to PDF files. |
|
|
/H |
When comparing HTML: Compare HTML script source and not textual content. |
|
|
/D |
Compare Folders (Directories). See /C switch also. |
/C |
Compare Sub folders. Only valid when /D switch is used. |
/U |
Folder Comparison, specify which extension(s) to compare. Leave blank to compare all extensions. To compare only DOC files use "/U *.DOC". Note that the asterisk character "*" is important. To compare DOC and HTM use "/U *.DOC *.HTM" |
|
|
/+{ini file override} |
Command line switch /+{DiffDoc.ini file path} was implemented to override the default ini file used: %appdata%\Softinterface, Inc\DiffDoc\DiffDoc.ini This could be useful for those command line switches that don't exist, yet the user interface retains those settings through the DiffDoc.ini file.
|
/CLEARHISTORY |
For security conscious individuals, this switch will keep the application from loading and saving any historical comparisons made during the previous runs of the program. Note that historical information may still be stored in the DiffDoc.ini file if this switch is not used every time the application is used. You can clear out any and all items from the DiffDoc.ini file located at: %appdata%\Softinterface, Inc\DiffDoc\DiffDoc.ini |
/? |
This command line information shows up |
|
|
/WPOO{Password} /WPOM{Password} |
WPOO = MS Word Password to Open Original file WPOM = MS Word Password to Open Modified file |
/WPOTO{Password} /WPOTM{Password} |
WPOTO = MS Word Password to Open Template of Original file WPOTM = MS Word Password to Open Template of Modified file |
/XPOO{Password} /XPOM{Password} |
XPOO = Excel Password to Open Original file XPOM = Excel Password to Open Modified file |
|
|
/AA# |
The parameter can be used to specify several things specific to the way a PDF is imported. You may use this switch as many times as you wish. Not specifying a particular option will cause it to default to what was last set by the user in the application (i.e. while not running in the command line). DOCUMENT LAYOUT 1 = Single Column Layout 2 = Multi-Column Layout 3 = Pleading CONVERSION METHOD 5 = Preserve Layout Using Spaces and Tabs 6 = Detect Headers TRUE 7 = Detect Headers FALSE 8 = Text Flow 9 = PDF is an OCR'd scanned image with textual content 10 = Remove Hidden Text TRUE 11 = Remove Hidden Text FALSE 12 = Connect Hyphens TRUE 13 = Connect Hyphens FALSE TEXT OPTIONS 22 = Merge Paragraph TRUE 23 = Merge Paragraph FALSE 24 = Shrink Fonts TRUE 25 = Shrink Fonts FALSE 26 = Adjust Font Names TRUE 27 = Adjust Font Names FALSE 28 = Extract Hyperlinks TRUE 29 = Extract Hyperlinks FALSE For example the argument below imports a PDF file to RTF using the single column layout with Text Boxes for exact position, and Merges Text. /AA1 /AA9 /AA10 |
|
|
/??? |
Not here, ask us, we may be able to accommodate you. Support@SoftInterface.com |
See Also:
Helpful Hints for Creating a Command Line
Command Line Examples - General File Comparison
Command Line Examples - Folder Comparison
Command Line Examples - Excel Files Comparison