ddiftext man page on Ultrix

Man page or keyword search:  
man Server   3690 pages
apropos Keyword Search (all sections)
Output format
Ultrix logo
[printable version]

ddiftext(1)							   ddiftext(1)

Name
       ddiftext - convert DDIF formatted files to text formatted files

Syntax
       ddiftext	  [-m	message_log]   [-O  optionfile]	 [-o  outputfile]  [-p
       options_line]... [-d extension] [inputfile [outputfile [logfile]]]

Description
       The ddiftext command reads a DDIF formatted  file  from	inputfile  and
       writes  a  text	file  to  outputfile.	To  convert  from file.ddif to
       file.text, type:

       ddiftext file.ddif file.text.

       If you do not supply an input file, or if you supply a minus  sign  (-)
       as  an  argument,  ddiftext reads the DDIF file from the standard input
       file.  If you do not supply an output file, or if you  supply  a	 minus
       sign  (-) as an argument, ddiftext writes the text file to the standard
       output file.

       You can also invoke the ddiftext conversion with	 the  cdoc(1)  command
       when you use that command and specify the option -d text.

       If the DDIF input file is a newer version of the DDIF grammar than that
       understood by the converter, data represented by the new	 grammar  ele‐
       ments is lost.  Any external file references within the DDIF input file
       are resolved.

       All Latin1 text in the intermediate representation of the input file is
       converted  to  the text output file. When converting an input file to a
       text output file, you should be aware that text output files  can  con‐
       tain  only  textual  content and minimal formatting such as line feeds,
       page breaks, and tabs.  The Text back end converter  preserves  format‐
       ting information to the extent possible. All graphics, images, and text
       attributes in the intermediate representation of	 the  input  file  are
       lost when converted to the text output file.

       A  document  syntax  error  in the DDIF input file causes a fatal input
       processing error. The conversion stops and no further input  processing
       occurs.

Options
       -m message_log
	    Enables  enhanced  messaging  and logs all messages to message_log
	    or, if '-' is specified, to standard error in place	 of  the  mes‐
	    sage_log.	If you do not specify this option, only serious errors
	    are reported.

       -O optionfile
	    Specifies the name of the options file containing options for this
	    converter.

		 The  options  file  has  a default file type of .cda_options.
		 Each line of the options file specifies a  format  name  that
		 can  optionally  be followed by _input or _output to restrict
		 the option to either an input or output converter. The second
		 word  is a valid option preceded by one or more spaces, tabs,
		 or a slash (/) and can contain uppercase and  lowercase  let‐
		 ters, numbers, dollar signs, and underlines. The case of let‐
		 ters is not significant. If an option requires a value,  then
		 spaces,  tabs,	 or an equal sign can separate the option from
		 the value.

		 You can precede any line by spaces and tabs.  To terminate  a
		 line,	use any character other than those used to specify the
		 format names and options. The syntax  and  interpretation  of
		 the  text  that  follows  the format name is specified by the
		 supplier of the front and back end converters for the	speci‐
		 fied format.

		 To  specify several options for the same input or output for‐
		 mat, specify one option on a line. If an invalid  option  for
		 an  input  or output format or an invalid value for an option
		 is specified, the option may be ignored or an	error  message
		 may  be  returned.  Each input or output format that supports
		 processing options specifies any restrictions or special for‐
		 mats required when specifying options.

		 By  default, any messages that occur during processing of the
		 options file are written to standard error.  For those	 input
		 and output formats that support a LOG option, messages can be
		 directed to a log file or to a common message log.

       -o outputfile
		 Specifies the name of the output file that is included in the
		 command syntax for compatibility with the cdoc command.

       -p options_line
		 Specifies  command  line  options.  This  option has the same
		 effect as specifying an options file for this converter.  You
		 can specify up to 100 options.

       -d extension
		 Specifies  a  default	file  extension for compatibility with
		 other operating systems.

Converter Processing Options
       ddiftext supports the following processing options in an	 options  file
       or in options specified on command lines:

       o  ASCII_FALLBACK [ON,OFF]
	    Causes  text output in 7-bit ASCII. The fallback representation of
	    the characters is described in the ASCII standard. If this	option
	    is	not specified, the default is OFF; if this option is specified
	    without a value, the default is ON.

       o  CONTENT_MESSAGES [ON,OFF]
	    Causes the converter to put a message in the output file each time
	    a  nontext	element	 is encountered.  If this option is not speci‐
	    fied, the default is OFF; if this option is	 specified  without  a
	    value, the default is ON.

       o  HEIGHT value
	    Specifies the maximum number of lines per page in your text output
	    file. If you specify zero, the number of lines per page will  cor‐
	    respond to the height specified in your document. If you addition‐
	    ally specify OVERRIDE_FORMAT, or if the document has  no  inherent
	    page size, the document is formatted to the height value specified
	    by this option. The default height is 66 lines.

       o  OVERRIDE_FORMAT [ON,OFF]
	    Causes the converter to ignore the document formatting information
	    in	the  document, so that the text is formatted on a single large
	    paragraph per page. Specify the size of the page by the HEIGHT and
	    WIDTH  processing  options.	 If  this option is not specified, the
	    default is OFF; if this option is specified without a  value,  the
	    default is ON.

       o  SOFT_DIRECTIVES [ON,OFF]
	    Causes  the converter to obey the soft directives contained in the
	    document when creating the text output file.  If  this  option  is
	    not	 specified,  the  default  is OFF; if this option is specified
	    without a value, the default is ON.

       o  WIDTH value
	    Specifies the maximum number of columns of characters per page  in
	    the	 text  output file. If you specify zero, the number of columns
	    per page will correspond to the width specified in your  document.
	    If	you  additionally  specify OVERRIDE_FORMAT, or if the document
	    has no inherent page size, the document is formatted to the	 value
	    specified  by this processing option.  If any lines of text exceed
	    this width	value,	the  additional	 columns  are  truncated.  The
	    default width is 80 characters.

See Also
       cdoc(1), dtifddif(1), textddif(1), vdoc(1), CDA(5), cda_msg(5), DDIF(5)

								   ddiftext(1)
[top]

List of man pages available for Ultrix

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net