svn commit: r325844 - stable/11/lib/libutil

[Rodney W. Grimes]

> Author: bapt
> Date: Wed Nov 15 12:17:51 2017
> New Revision: 325844
> URL: https://svnweb.freebsd.org/changeset/base/325844
> 
> Log:
>   MFC r325716:
>   
>   Fix some nroff style issue
> 
> Modified:
>   stable/11/lib/libutil/hexdump.3
> Directory Properties:
>   stable/11/   (props changed)
> 
> Modified: stable/11/lib/libutil/hexdump.3
> ==============================================================================
> --- stable/11/lib/libutil/hexdump.3	Wed Nov 15 11:35:02 2017	(r325843)
> +++ stable/11/lib/libutil/hexdump.3	Wed Nov 15 12:17:51 2017	(r325844)
> @@ -42,14 +42,9 @@
>  The
>  .Fn hexdump
>  function prints an array of bytes to standard out in hexadecimal form,
> -along with the
> -.Tn ASCII
> -representation of the bytes, if possible.
> -By default, each line of
> -output will start with an offset count, followed by 16 hexadecimal values,
> -followed by 16
> -.Tn ASCII
> -characters.
> +along with the ASCII representation of the bytes, if possible.
> +By default, each line of output will start with an offset count, followed by 16
> +hexadecimal values, followed by 16 ASCII characters.

Just for the future, the old school way of dong this would be:
By default,
each line of output will start with an offset count,
followed by 16 hexadecimal values,
followed by 16 ASCII characters.

IE, you put each fragment of a sentance on its own line.   It is
bad form in .troff to try and pack lines full.

I am not sure why we are removing the troff .Tn macro, mandoc
may do nothing with it, but if someone formats the man page
for a typesetter this does make the ASCII look special.

>  .Bl -tag -width indent
>  .It Fa ptr
>  Pointer to the array of bytes to print.
> @@ -73,12 +68,10 @@ Flags for controlling the formatting of the output.
>  Integer value of the number of bytes to display on each line.
>  A value of 0 implies that the default value of 16 will be used.
>  .It Bits 8-15
> -Character
> -.Tn ASCII
> -value to use as the separator for the hexadecimal output.
> +Character ASCII value to use as the separator for the hexadecimal output.
>  A value of 0 implies that the default value of 32
> -.Tn ( ASCII
> -space) will be used.
> +.Pq ASCII space
> +will be used.
>  .It Dv HD_OMIT_COUNT
>  Do not print the offset column at the beginning of each line.
>  .It Dv HD_OMIT_HEX
> 
> 

-- 
Rod Grimes                                                 rgrimes at freebsd.org