[no parameter]
|
Invoke the Create Page Checksum Report dialog box.
|
||||||||||||
start page
|
The first of a range of pages to be included in the report (defaults to first page of document)
|
||||||||||||
end page
|
The last of a range of pages to be included in the report (defaults to last page of document)
|
||||||||||||
view number
|
The view number upon which to report (defaults to the main view 0)
|
||||||||||||
report name
|
The name of the text stream that will contain the report.
|
||||||||||||
report type
|
The type of report to be generated: a full report will include a line for every page in the specified range. Other report types will be compared against a previous report, whose name is defined in the next parameter.
|
||||||||||||
old report
|
The name of the old report to be used as comparison when using report types 1, 2, 3 or 4. The parameter must not be present for report type 0, but must be present for other types. For a successful comparison, the following parameters should all be the same as they were when the old report was produced.
|
||||||||||||
page show
|
A show string for generating page numbers in the report. The default value is $p, which displays point numbers when frozen pages are involved and pages have been inserted. The result of this show string is used to find matching lines of a report when comparing reports with report types 1...4.
|
||||||||||||
line style
|
The tag style for an entire report line: this parameter cannot be empty and defaults to ck line.
|
||||||||||||
page style
|
The tag style for the page number: this parameter cannot be empty and defaults to ck page.
|
||||||||||||
trf style
|
The tag style to use for the trf checksum of a page: defaults to ck trf. If this parameter is the empty string then trf checksums are not included in the report.
|
||||||||||||
tformat style
|
The tag style to use for the tformat checksum of a page: defaults to ck format. If this parameter is the empty string then tformat checksums are not included in the report.
|
||||||||||||
tprint style
|
The tag style to use for the tprint checksum of a page: defaults to ck tprint. If this parameter is the empty string then tprint checksums are not included in the report.
|
|
Checksums must be enabled before use, via the Document Preferences dialog box. See tdpref and fdpref for further information.
|
|
As well as producing a report, current page checksum values can also be queried using the toolbar cksumbar or the three checksum getvar codes, corresponding to the following commands:
21731
trf: page re-formats
21732
tformat: major re-formats
21733
tprint: printing the page(s)
|
|
By default all frames are included in the checksum report, but the tfckskip macro can be used to exclude a frame from the report, for example one that contains date/time information. The getvar code 01566 will return whether the current frame is skipped. It is still possible for a skipped frame to affect the checksum if it changes the position or flow of other text on a page that is included.
|
|
The way in which the checksum value is generated may vary between software versions: changes made to the page draw process during development and bug fixes will have an effect.
|