Blame SOURCES/0003-Use-comments-to-separate-sections-in-manual-pages.patch

65c10b
From ae28cbb12fc80f62230ad06cb44ad0aaaa9e2048 Mon Sep 17 00:00:00 2001
65c10b
From: Jean Delvare <jdelvare@suse.de>
65c10b
Date: Tue, 29 Jan 2019 14:11:46 +0100
65c10b
Subject: [PATCH 03/11] Use comments to separate sections in manual pages
65c10b
65c10b
Blank lines are interpreted as actual blank lines in manual pages.
65c10b
Use comments instead to visually separate sections. Otherwise an
65c10b
extra blank like is inserted before every section.
65c10b
65c10b
Signed-off-by: Jean Delvare <jdelvare@suse.de>
65c10b
---
65c10b
 man/biosdecode.8 | 11 ++++++++---
65c10b
 man/dmidecode.8  | 18 +++++++++++-------
65c10b
 man/ownership.8  | 10 +++++++---
65c10b
 man/vpddecode.8  | 12 +++++++-----
65c10b
 4 files changed, 33 insertions(+), 18 deletions(-)
65c10b
65c10b
diff --git a/man/biosdecode.8 b/man/biosdecode.8
65c10b
index a96eb681c136..cf7d4db01249 100644
65c10b
--- a/man/biosdecode.8
65c10b
+++ b/man/biosdecode.8
65c10b
@@ -1,10 +1,12 @@
65c10b
 .TH BIOSDECODE 8 "February 2007" "dmidecode"
65c10b
+.\"
65c10b
 .SH NAME
65c10b
 biosdecode \- \s-1BIOS\s0 information decoder
65c10b
+.\"
65c10b
 .SH SYNOPSIS
65c10b
 .B biosdecode
65c10b
 .RB [ OPTIONS ]
65c10b
-
65c10b
+.\"
65c10b
 .SH DESCRIPTION
65c10b
 .B biosdecode
65c10b
 parses the \s-1BIOS\s0 memory and prints information about all structures (or
65c10b
@@ -54,7 +56,7 @@ started its life as a part of
65c10b
 .B dmidecode
65c10b
 but as more entry point types were added, it was moved to a different
65c10b
 program.
65c10b
-
65c10b
+.\"
65c10b
 .SH OPTIONS
65c10b
 .TP
65c10b
 .BR "-d" ", " "--dev-mem FILE"
65c10b
@@ -68,17 +70,20 @@ Display usage information and exit
65c10b
 .TP
65c10b
 .BR "-V" ", " "--version"
65c10b
 Display the version and exit
65c10b
-
65c10b
+.\"
65c10b
 .SH FILES
65c10b
 .I /dev/mem
65c10b
+.\"
65c10b
 .SH BUGS
65c10b
 Most of the time,
65c10b
 .B biosdecode
65c10b
 prints too much information (you don't really care about addresses)
65c10b
 or not enough (because it doesn't follow pointers and has no lookup
65c10b
 tables).
65c10b
+.\"
65c10b
 .SH AUTHORS
65c10b
 Alan Cox, Jean Delvare
65c10b
+.\"
65c10b
 .SH "SEE ALSO"
65c10b
 .BR dmidecode (8),
65c10b
 .BR mem (4),
65c10b
diff --git a/man/dmidecode.8 b/man/dmidecode.8
65c10b
index 52100a82435e..1f6529d99e91 100644
65c10b
--- a/man/dmidecode.8
65c10b
+++ b/man/dmidecode.8
65c10b
@@ -1,10 +1,12 @@
65c10b
 .TH DMIDECODE 8 "January 2019" "dmidecode"
65c10b
+.\"
65c10b
 .SH NAME
65c10b
 dmidecode \- \s-1DMI\s0 table decoder
65c10b
+.\"
65c10b
 .SH SYNOPSIS
65c10b
 .B dmidecode
65c10b
 .RB [ OPTIONS ]
65c10b
-
65c10b
+.\"
65c10b
 .SH DESCRIPTION
65c10b
 .B dmidecode
65c10b
 is a tool for dumping a computer's \s-1DMI\s0 (some say \s-1SMBIOS\s0) table
65c10b
@@ -58,7 +60,7 @@ displayed value.
65c10b
 Decoded values. The information presented of course depends on the type
65c10b
 of record. Here, we learn about the board's manufacturer, model, version
65c10b
 and serial number.
65c10b
-
65c10b
+.\"
65c10b
 .SH OPTIONS
65c10b
 .TP
65c10b
 .BR "-d" ", " "--dev-mem FILE"
65c10b
@@ -158,10 +160,9 @@ is run on a system with BIOS that boasts new SMBIOS specification, which
65c10b
 is not supported by the tool yet, it will print out relevant message in
65c10b
 addition to requested data on the very top of the output. Thus informs the
65c10b
 output data is not reliable.
65c10b
-
65c10b
+.\"
65c10b
 .SH "DMI TYPES"
65c10b
 The \s-1SMBIOS\s0 specification defines the following \s-1DMI\s0 types:
65c10b
-
65c10b
 .TS
65c10b
 r l
65c10b
 __
65c10b
@@ -246,7 +247,7 @@ dmidecode --type 0,13
65c10b
 dmidecode --type bios
65c10b
 .IP \(bu
65c10b
 dmidecode --type BIOS
65c10b
-
65c10b
+.\"
65c10b
 .SH BINARY DUMP FILE FORMAT
65c10b
 The binary dump files generated by --dump-bin and read using --from-dump
65c10b
 are formatted as follows:
65c10b
@@ -255,7 +256,7 @@ The SMBIOS or DMI entry point is located at offset 0x00.
65c10b
 It is crafted to hard-code the table address at offset 0x20.
65c10b
 .IP \(bu "\w'\(bu'u+1n"
65c10b
 The DMI table is located at offset 0x20.
65c10b
-
65c10b
+.\"
65c10b
 .SH UUID FORMAT
65c10b
 There is some ambiguity about how to interpret the UUID fields prior to SMBIOS
65c10b
 specification version 2.6. There was no mention of byte swapping, and RFC 4122
65c10b
@@ -269,7 +270,7 @@ compatibility, it was decided to interpret the UUID fields according to RFC
65c10b
 4122 (no byte swapping) when the SMBIOS version is older than 2.6, and to
65c10b
 interpret the first 3 fields as little-endian (byte-swapped) when the SMBIOS
65c10b
 version is 2.6 or later. The Linux kernel follows the same logic.
65c10b
-
65c10b
+.\"
65c10b
 .SH FILES
65c10b
 .I /dev/mem
65c10b
 .br
65c10b
@@ -278,11 +279,14 @@ version is 2.6 or later. The Linux kernel follows the same logic.
65c10b
 .br
65c10b
 .I /sys/firmware/dmi/tables/DMI
65c10b
 (Linux only)
65c10b
+.\"
65c10b
 .SH BUGS
65c10b
 More often than not, information contained in the \s-1DMI\s0 tables is inaccurate,
65c10b
 incomplete or simply wrong.
65c10b
+.\"
65c10b
 .SH AUTHORS
65c10b
 Alan Cox, Jean Delvare
65c10b
+.\"
65c10b
 .SH "SEE ALSO"
65c10b
 .BR biosdecode (8),
65c10b
 .BR mem (4),
65c10b
diff --git a/man/ownership.8 b/man/ownership.8
65c10b
index f24ef9437e21..71ed78844081 100644
65c10b
--- a/man/ownership.8
65c10b
+++ b/man/ownership.8
65c10b
@@ -1,10 +1,12 @@
65c10b
 .TH OWNERSHIP 8 "February 2005" "dmidecode"
65c10b
+.\"
65c10b
 .SH NAME
65c10b
 ownership \- Compaq ownership tag retriever
65c10b
+.\"
65c10b
 .SH SYNOPSIS
65c10b
 .B ownership
65c10b
 .RB [ OPTIONS ]
65c10b
-
65c10b
+.\"
65c10b
 .SH DESCRIPTION
65c10b
 .B ownership
65c10b
 retrieves and prints the "ownership tag" that can be set on Compaq
65c10b
@@ -14,7 +16,7 @@ package,
65c10b
 .B ownership
65c10b
 doesn't print any version information, nor labels, but only the raw
65c10b
 ownership tag. This should help its integration in scripts.
65c10b
-
65c10b
+.\"
65c10b
 .SH OPTIONS
65c10b
 .TP
65c10b
 .BR "-d" ", " "--dev-mem FILE"
65c10b
@@ -25,11 +27,13 @@ Display usage information and exit
65c10b
 .TP
65c10b
 .BR "-V" ", " "--version"
65c10b
 Display the version and exit
65c10b
-
65c10b
+.\"
65c10b
 .SH FILES
65c10b
 .I /dev/mem
65c10b
+.\"
65c10b
 .SH AUTHOR
65c10b
 Jean Delvare
65c10b
+.\"
65c10b
 .SH "SEE ALSO"
65c10b
 .BR biosdecode (8),
65c10b
 .BR dmidecode (8),
65c10b
diff --git a/man/vpddecode.8 b/man/vpddecode.8
65c10b
index c9e4acfd2fb9..1cc2b76ce552 100644
65c10b
--- a/man/vpddecode.8
65c10b
+++ b/man/vpddecode.8
65c10b
@@ -1,10 +1,12 @@
65c10b
 .TH VPDDECODE 8 "February 2007" "dmidecode"
65c10b
+.\"
65c10b
 .SH NAME
65c10b
 vpddecode \- \s-1VPD\s0 structure decoder
65c10b
+.\"
65c10b
 .SH SYNOPSIS
65c10b
 .B vpddecode
65c10b
 .RB [ OPTIONS ]
65c10b
-
65c10b
+.\"
65c10b
 .SH DESCRIPTION
65c10b
 .B vpddecode
65c10b
 prints the "vital product data" information that can be found in almost
65c10b
@@ -17,19 +19,17 @@ Box Serial Number
65c10b
 Motherboard Serial Number
65c10b
 .IP \(bu
65c10b
 Machine Type/Model
65c10b
-
65c10b
 .PP
65c10b
 Some systems have these additional items:
65c10b
 .IP \(bu "\w'\(bu'u+1n"
65c10b
 BIOS Release Date
65c10b
 .IP \(bu
65c10b
 Default Flash Image File Name
65c10b
-
65c10b
 .PP
65c10b
 Note that these additional items are not documented by IBM, so this is
65c10b
 guess work, and as such should not be blindly trusted. Feedback about
65c10b
 the accuracy of these labels is welcome.
65c10b
-
65c10b
+.\"
65c10b
 .SH OPTIONS
65c10b
 .TP
65c10b
 .BR "-d" ", " "--dev-mem FILE"
65c10b
@@ -62,11 +62,13 @@ Display usage information and exit
65c10b
 .TP
65c10b
 .BR "-V" ", " "--version"
65c10b
 Display the version and exit
65c10b
-
65c10b
+.\"
65c10b
 .SH FILES
65c10b
 .I /dev/mem
65c10b
+.\"
65c10b
 .SH AUTHOR
65c10b
 Jean Delvare
65c10b
+.\"
65c10b
 .SH "SEE ALSO"
65c10b
 .BR biosdecode (8),
65c10b
 .BR dmidecode (8),
65c10b
-- 
65c10b
2.17.1
65c10b