[PATCH] proc(5): fix indentation for net examples

[PATCH] proc(5): fix indentation for net examples

[Mike Frysinger]

Signed-off-by: Mike Frysinger <vapier-aBrp7R+bbdUdnm+yROfE0A@public.gmane.org>
---
 man5/proc.5 | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/man5/proc.5 b/man5/proc.5
index 942b833..60829b2 100644
--- a/man5/proc.5
+++ b/man5/proc.5
@@ -2023,14 +2023,12 @@ The format is:
 
 .nf
 .ft CW
-.in 1n
 Inter-|   Receive                                                |  Transmit
  face |bytes    packets errs drop fifo frame compressed multicast|bytes    packets errs drop fifo colls carrier compressed
     lo: 2776770   11307    0    0    0     0          0         0  2776770   11307    0    0    0     0       0          0
   eth0: 1215645    2751    0    0    0     0          0         0  1782404    4324    0    0    0   427       0          0
   ppp0: 1622270    5552    1    0    0     0          0         0   354130    5669    0    0    0     0       0          0
   tap0:    7714      81    0    0    0     0          0         0     7714      81    0    0    0     0       0          0
-.in
 .ft
 .fi
 .\" .TP
@@ -2126,12 +2124,10 @@ The format is:
 
 .nf
 .ft CW
-.in 1n
 sl  local_address rem_address   st tx_queue rx_queue tr rexmits  tm\->when uid
  1: 01642C89:0201 0C642C89:03FF 01 00000000:00000001 01:000071BA 00000000 0
  1: 00000000:0801 00000000:0000 0A 00000000:00000000 00:00000000 6F000100 0
  1: 00000000:0201 00000000:0000 0A 00000000:00000000 00:00000000 00000000 0
-.in
 .ft
 .fi
 .TP
-- 
1.8.4.3

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: [PATCH] proc(5): fix indentation for net examples

[Michael Kerrisk (man-pages)]

On 12/29/13 02:26, Mike Frysinger wrote:
> Signed-off-by: Mike Frysinger <vapier-aBrp7R+bbdUdnm+yROfE0A@public.gmane.org>

Hi Mike,

I'm not sure what the goal of this change is. What's broken?
(Note that there is some value, in terms of easy parsing of
man output, to having only the section headings start in 
column 1.)

Cheers,

Michael


> ---
>  man5/proc.5 | 4 ----
>  1 file changed, 4 deletions(-)
> 
> diff --git a/man5/proc.5 b/man5/proc.5
> index 942b833..60829b2 100644
> --- a/man5/proc.5
> +++ b/man5/proc.5
> @@ -2023,14 +2023,12 @@ The format is:
>  
>  .nf
>  .ft CW
> -.in 1n
>  Inter-|   Receive                                                |  Transmit
>   face |bytes    packets errs drop fifo frame compressed multicast|bytes    packets errs drop fifo colls carrier compressed
>      lo: 2776770   11307    0    0    0     0          0         0  2776770   11307    0    0    0     0       0          0
>    eth0: 1215645    2751    0    0    0     0          0         0  1782404    4324    0    0    0   427       0          0
>    ppp0: 1622270    5552    1    0    0     0          0         0   354130    5669    0    0    0     0       0          0
>    tap0:    7714      81    0    0    0     0          0         0     7714      81    0    0    0     0       0          0
> -.in
>  .ft
>  .fi
>  .\" .TP
> @@ -2126,12 +2124,10 @@ The format is:
>  
>  .nf
>  .ft CW
> -.in 1n
>  sl  local_address rem_address   st tx_queue rx_queue tr rexmits  tm\->when uid
>   1: 01642C89:0201 0C642C89:03FF 01 00000000:00000001 01:000071BA 00000000 0
>   1: 00000000:0801 00000000:0000 0A 00000000:00000000 00:00000000 6F000100 0
>   1: 00000000:0201 00000000:0000 0A 00000000:00000000 00:00000000 00000000 0
> -.in
>  .ft
>  .fi
>  .TP
> 


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: [PATCH] proc(5): fix indentation for net examples

[Mike Frysinger]

[-- Attachment #1: Type: Text/Plain, Size: 827 bytes --]

On Monday 30 December 2013 06:27:19 Michael Kerrisk (man-pages) wrote:
> On 12/29/13 02:26, Mike Frysinger wrote:
> > Signed-off-by: Mike Frysinger <vapier-aBrp7R+bbdUdnm+yROfE0A@public.gmane.org>
> 
> I'm not sure what the goal of this change is. What's broken?
> (Note that there is some value, in terms of easy parsing of
> man output, to having only the section headings start in
> column 1.)

i'm not sure what you mean here.  having it at col 1 makes scanning the man 
page harder imo, and indenting it to match the content that it's part of makes 
sense.  it's what most every other section does in this man page already.

if you're worried about 80 cols, then this table already widely exceeds that 
limit even when placed at col 1.  so fixing the indentation doesn't really hurt 
that scenario.
-mike

[-- Attachment #2: This is a digitally signed message part. --]
[-- Type: application/pgp-signature, Size: 836 bytes --]

Re: [PATCH] proc(5): fix indentation for net examples

[Michael Kerrisk (man-pages)]

On 12/31/13 18:43, Mike Frysinger wrote:
> On Monday 30 December 2013 06:27:19 Michael Kerrisk (man-pages) wrote:
>> On 12/29/13 02:26, Mike Frysinger wrote:
>>> Signed-off-by: Mike Frysinger <vapier-aBrp7R+bbdUdnm+yROfE0A@public.gmane.org>
>>
>> I'm not sure what the goal of this change is. What's broken?
>> (Note that there is some value, in terms of easy parsing of
>> man output, to having only the section headings start in
>> column 1.)
> 
> i'm not sure what you mean here.  having it at col 1 makes scanning the man 
> page harder imo, and indenting it to match the content that it's part of makes 
> sense.  it's what most every other section does in this man page already.
> 
> if you're worried about 80 cols, then this table already widely exceeds that 
> limit even when placed at col 1.  so fixing the indentation doesn't really hurt 
> that scenario.
> -mike

I misread your patch somewhat. However, I prefer to keep things the way they
are, for a couple of reasons. First, these sort of adjustments do allow some
of the other tables to fit in 80 columns where they would not otherwise do so.
Second, they reduce the min. width of the terminal window that is required 
to properly display the tables.

Cheers,

Michael


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html