1 SDDRAW
!
The SDDRAW utility creates a file containing a diagram of the subdirectory
tree structure under a specified directory.  If no directory is specified,
the structure under the current default directory is diagrammed.

	$  SDDRAW  { directory }  { qualifier(s) ... }

When complete, SDDRAW outputs a message showing the number of printer col-
umns in the diagram, to help in deciding how to print or process the file.

Defaults (which can be overridden):
	The output file is SDDRAW.LIS in the current default directory.
	Output is single spaced.
	Up to four levels of subdirectories are shown.
	Directory names longer than 13 characters are truncated.  |
	The diagram uses "-", "|", and "+" to draw lines, as in:  +- A -+- B
								  |	+- C
								  +- D
!
2 Parameter
!
If a parameter is specified on the SDDRAW command, it must be a directory
name, and SDDRAW diagrams this directory.  If no parameter is specified,
SDDRAW diagrams the current default directory.  A device name or logical
name may be used.  A node name, or wild cards, may NOT be used.

	Examples:	$ SDDRAW UDISK2:[MYDIR]

			$ SDDRAW [-.LATERAL]
!
2 Qualifiers
/OUTPUT

  /OUTPUT=filename

  By default SDDRAW creates the diagram as the file SDDRAW.LIS in the
  current default directory.  This may be changed by using the /OUTPUT
  qualifier.  If a full file specification is not supplied, the defaults
  are taken from the specification:

	SYS$DISK:[]SDDRAW.LIS;<n+1>

  Where SYS$DISK is the current default disk, [] is the current default
  directory, and "n" is the current existing version, if any, of the
  file SDDRAW.LIS.

/MAXSIZE

  /MAXSIZE=n (n = 9 to 39)

  By default, SDDRAW truncates directory names which are over 13 char-
  acters long.  This may be changed by using the /MAXSIZE qualifier.
  If /MAXSIZE=39 is specified, directory names will never be truncated,
  since directory names will always be 39 or fewer characters long.

  When a directory name is truncated, the untruncated part will be fol-
  lowed by either an asterisk (if neither /X9700 nor /LQP is used), a
  diamond (if /LQP is used), or a bullet (if /X9700 is used).

  This qualifier may be used to control the printable width of the
  diagram.

/LEVELS

  /LEVELS=n (n = 1 to 8)

  By default, SDDRAW displays up to four levels of subdirectories under
  the specified directory.  This may be changed by using the /LEVELS
  qualifier.

  If more levels exist than are specified to be displayed, the diagram
  contains right arrows at points where additional levels exist.

  This qualifier may be used to control the printable width of the
  diagram.

/X9700

  /X9700

  When the /X9700 qualifier is present, the diagram is formatted using
  line-drawing characters available only on the NSWC Xerox 4050 and 9790
  Laser Printing Systems.

  When this qualifier is used, the diagram file must be sent through
  the LASER utility to be properly printed.

  If the diagram file is further processed before being LASERed (for
  example, if it is .REQUIREd into a RNO document), it must be noted
  that the diagram will only print correctly in Font 1 (i.e. if bold-
  faced, it will not print correctly).

  If neither the /X9700 nor the /LQP qualifier (which are mutually
  exclusive) are used, the diagram is formatted using the characters

	-	+	|

 to draw the lines.

/LQP

  /LQP

  When the /LQP qualifier is present, the diagram is formatted using
  line-drawing characters available only on DEC and DEC-compatible
  terminals and letter-quality printers.

  The diagram will display correctly on VT terminals, the LPS40 printer
  (the VAXcluster "LQP" printer), and personal LA75 and LN03 printers,
  among others.  It will not display correctly on line printers (i.e.
  printers using 11-by-14 inch fanfold paper).

  If neither the /X9700 nor the /LQP qualifier (which are mutually
  exclusive) are used, the diagram is formatted using the characters

	-	+	|

 to draw the lines.

/CLARIFY

  /CLARIFY

  When the /X9700 and /LQP qualifiers are not used, SDDRAW uses the
  characters "-", "+", and "|" to draw the diagram.  Unless /DOUBLE_SPACE
  is specified, there may be certain parts of the diagram which appear
  ambiguous.  An example is:
				|
				+- A -+- B
				|     +- C
				+- D -+- E
				      +- F

  where it appears that there is a connection between subdirectories
  C and E.

  When the /CLARIFY qualifier is used, SDDRAW inserts an extra line
  between any lines which may appear ambiguous.  The above example
  would appear as:
				|
				+- A -+- B
				|     +- C
		Added -->	|
				+- D -+- E
				      +- F

  The /CLARIFY qualifier is not needed, and is not allowed, if any of
  the qualifiers /X9700, /LQP, or /DOUBLE_SPACE are used.

/DOUBLE_SPACE

  /DOUBLE_SPACE

  By default, the output diagram is single spaced.  If the /DOUBLE_SPACE
  qualifier is used, the output is double spaced.  In certain cases this
  may create a better-looking diagram.

