Source Mage code commit list

[Ismael Luceno <scm AT sourcemage.org>]

GIT changes to master grimoire by Ismael Luceno <ismael AT sourcemage.org>:

 archive/lha/HISTORY                |    3 
 archive/lha/lha.1                  |  162 ++++------
 devel/uasm/HISTORY                 |    3 
 devel/uasm/uasm.1                  |  257 +++++++--------
 smgl/smgl-setup/HISTORY            |    3 
 smgl/smgl-setup/files/smgl-setup.7 |  595 
+++++++++++++++++++------------------
 6 files changed, 518 insertions(+), 505 deletions(-)

New commits:
commit 5ca9bd9ee7dd545da9462070d8eb9f361c481146
Author: Ismael Luceno <ismael AT sourcemage.org>
Commit: Ismael Luceno <ismael AT sourcemage.org>

    uasm: Convert man page to mdoc

commit 89fc5240f67b76e1ea6b9cf1989e4fdef57a3d0c
Author: Ismael Luceno <ismael AT sourcemage.org>
Commit: Ismael Luceno <ismael AT sourcemage.org>

    lha: Convert man page to mdoc

commit 0ed8c5545e34d4b46678b018fe91d3db664cca43
Author: Ismael Luceno <ismael AT sourcemage.org>
Commit: Ismael Luceno <ismael AT sourcemage.org>

    smgl-setup: Convert man page to mdoc

diff --git a/archive/lha/HISTORY b/archive/lha/HISTORY
index 84dd2a2..1da5c32 100644
--- a/archive/lha/HISTORY
+++ b/archive/lha/HISTORY
@@ -1,3 +1,6 @@
+2026-10-06 Ismael Luceno <ismael AT sourcemage.org>
+       * lha.1: Convert man page to mdoc
+
 2015-10-29 Ismael Luceno <ismael AT sourcemage.org>
        * BUILD, PRE_BUILD: Moved patching instructions to PRE_BUILD
          Merged sedit code into a single script
diff --git a/archive/lha/lha.1 b/archive/lha/lha.1
index 8dce26e..808e577 100644
--- a/archive/lha/lha.1
+++ b/archive/lha/lha.1
@@ -1,93 +1,71 @@
-.\" define .EX/.EE (for multiline user-command examples; normal Courier font)
-.de EX
-.in +4n
-.nf
-.ft CW
-..
-.de EE
-.ft R
-.fi
-.in -4n
-..
-.\" =========================================================================
-.TH LHA 1
-.SH NAME
-lha \- lzh un-archiver
-.PD
-.SH SYNOPSIS
-\fBlha\fP [\fB\-\fP] {\fB\ axelvudmcp\fP} [\fB\qvnfodizg012\fP] [\fB\ 
w=<dir>\fP]
-\fIarchive_file [\fIfile(s)\fP\]
-.PD
-.\" =========================================================================
-.SH DESCRIPTION
-The \fIlha\fP program displays or extracts the contents of a LZH archive.
-For a list of commands, please refer to the executable. It will display a 
list 
-of valid commands and modifiers if you omit any parameter.
-.PD
-.\" =========================================================================
-.SH ARGUMENTS
-.TP
-.IR a
-add (or replace) to archive
-.TP
-.IR l,v
-list, verbose list
-.TP
-.IR u 
-update newer files to archive
-.TP
-.IR d
-delete from archive
-.TP
-.IR m
-move to archive
-.TP
-.IR c
-reconstruct new archive
-.TP
-.IR p
-print to STDOUT from archive
-.TP
-.IR t
-test file CRC in archive
-.\" =========================================================================
-.SH OPTIONS
-.B q
-quiet
-.TP
-.B v
-verbose
-.TP
-.B n
-not execute
-.TP
-.B f
-force (overwrite at extract)
-.TP
-.B t
-FILES are TEXT-files
-.TP
-.B o
-use LHarc compatible compression method
-.TP
-.B w=dir
-specify extract directory
-.TP
-.B d
-delete files afterwards
-.TP
-.B i
-ignore directory path
-.TP
-.B z
-files not compress
-.TP
-.B g
-Generic format (for compatibility)
-.TP
-.B 0,1,2
-header level
-.TP
-.B e
+.Dd October 29, 2015
+.Dt LHA 1
+.Os
+.Sh NAME
+.Nm lha
+.Nd lzh un-archiver
+.Sh SYNOPSIS
+.Nm
+.Op Fl axelvudmcp
+.Op Fl qvnfodizg012
+.Op Fl w Ns = Ns Ar dir
+.Ar archive_file
+.Op Ar files
+.Sh DESCRIPTION
+The
+.Nm
+program displays or extracts the contents of an LZH archive.
+For a list of commands, refer to the executable itself: running
+.Nm
+without any parameter displays the list of valid commands and modifiers.
+.Sh COMMANDS
+.Bl -tag -width Ds
+.It Fl a
+Add files to the archive, replacing existing entries
+.It Fl l , Fl v
+List the archive contents;
+.Fl v
+gives a verbose listing
+.It Fl u
+Update newer files in the archive
+.It Fl d
+Delete files from the archive
+.It Fl m
+Move files into the archive
+.It Fl c
+Reconstruct a new archive
+.It Fl p
+Print files from the archive to standard output
+.It Fl t
+Test the file CRC in the archive
+.El
+.Sh OPTIONS
+.Bl -tag -width Ds
+.It Fl q
+Quiet
+.It Fl v
+Verbose
+.It Fl n
+Do not execute
+.It Fl f
+Force, overwriting when extracting
+.It Fl t
+Files are TEXT-files
+.It Fl o
+Use the LHarc compatible compression method
+.It Fl w Ar dir
+Extract into
+.Ar dir
+.It Fl d
+Delete files afterwards
+.It Fl i
+Ignore the directory path
+.It Fl z
+Files not compress
+.It Fl g
+Generic format, for compatibility
+.It Fl 0 , Fl 1 , Fl 2
+Header level
+.It Fl e
 TEXT code convert from/to EUC
-.PD
+.El
diff --git a/devel/uasm/HISTORY b/devel/uasm/HISTORY
index 5eb1745..430ea09 100644
--- a/devel/uasm/HISTORY
+++ b/devel/uasm/HISTORY
@@ -1,3 +1,6 @@
+2026-10-06 Ismael Luceno <ismael AT sourcemage.org>
+       * uasm.1: Convert man page to mdoc
+
 2026-10-04 Ismael Luceno <ismael AT sourcemage.org>
        * DETAILS, BUILD, INSTALL, PRE_BUILD, WATCH, uasm.1,
          patches/0001-Declare-strupr-for-the-Unix-build.patch,
diff --git a/devel/uasm/uasm.1 b/devel/uasm/uasm.1
index 233de6b..151cf96 100644
--- a/devel/uasm/uasm.1
+++ b/devel/uasm/uasm.1
@@ -1,185 +1,166 @@
-.TH UASM 1 "October 2026" "uasm 2.57r" "User Commands"
-.SH NAME
-uasm \- Masm-compatible macro assembler
-.SH SYNOPSIS
-.B uasm
-.RI [ options ]
-.IR asm-file ...
-.RI [ @env_var ]
-.SH DESCRIPTION
-.B uasm
-assembles Intel syntax assembly into object files or flat binaries.  It is a
-fork of JWasm and reads Masm source: the
-.B .MODEL
+.Dd October 3, 2026
+.Dt UASM 1
+.Os "uasm 2.57r"
+.Sh NAME
+.Nm uasm
+.Nd Masm-compatible macro assembler
+.Sh SYNOPSIS
+.Nm
+.Op Ar options
+.Op Ar asm-file ...
+.Op Ar @ Ns Ar env_var
+.Sh DESCRIPTION
+.Nm
+assembles Intel syntax assembly into object files or flat binaries.
+It is a fork of JWasm and reads Masm source: the
+.Ic .MODEL
 directive, the
-.B PROC
+.Ic .PROC
 and
-.B ENDP
+.Ic .ENDP
 procedure forms and the usual segment and data directives all work, and an
-internal macro library provides the Masm mnemonics.  Extensions over Masm,
-and the places where the syntax differs from it, are listed in
-.IR Doc/enh.txt .
-.PP
+internal macro library provides the Masm mnemonics.
+Extensions over Masm, and the places where the syntax differs from it, are
+listed in
+.Pa Doc/enh.txt .
+.Pp
 Unless another output format is selected, objects are written in Intel OMF.
 Formats such as
-.BR -bin ,
-.B -mz
+.Fl bin ,
+.Fl mz
 and
-.B -pe
+.Fl pe
 produce a linked image rather than a relocatable object, and are meant for
 boot sectors, DOS and Windows executables.
-.PP
+.Pp
 Any number of source files may be given, each with its own options.
-.B @
-arguments read further options from an environment variable, or from a file
-named by it.
-.SH OPTIONS
-.SS Output format
-.TP
-.B -bin
+Arguments prefixed with
+.Ql @
+read further options from an environment variable, or from a file named by 
it.
+.Sh OPTIONS
+.Ss Output format
+.Bl -tag -width Ds
+.It Fl bin
 Plain binary output.
-.TP
-.B -coff
+.It Fl coff
 MS COFF object, 32-bit.
-.TP
-.B -elf
+.It Fl elf
 ELF object, 32-bit.
-.TP
-.B -elf64
+.It Fl elf64
 ELF object, 64-bit.
-.TP
-.B -macho64
+.It Fl macho64
 Mach-O object, 64-bit.
-.TP
-.B -mz
+.It Fl mz
 DOS MZ executable.
-.TP
-.B -omf
-Intel OMF object.  This is the default.
-.TP
-.B -pe
+.It Fl omf
+Intel OMF object.
+This is the default.
+.It Fl pe
 Windows PE executable, 32 or 64-bit.
-.TP
-.B -win64
+.It Fl win64
 MS COFF object, 64-bit.
-.TP
-.B -pie
-Generate a position independent image.  ELF64 and Mach-O64 only.
-.SS File names
-.TP
-.BI -Fo " file"
+.It Fl pie
+Generate a position independent image.
+ELF64 and Mach-O64 only.
+.El
+.Ss File names
+.Bl -tag -width Ds
+.It Fl Fo Ar file
 Write the object to
-.IR file .
+.Ar file .
 A name without an extension gets
-.B .o
+.Ql .o
 appended.
-.TP
-.BI -Fl " file"
+.It Fl Fl Ar file
 Write a listing to
-.IR file .
-.TP
-.BI -Fw " file"
+.Ar file .
+.It Fl Fw Ar file
 Write errors to
-.IR file .
-.TP
-.BI -Fi " file"
+.Ar file .
+.It Fl Fi Ar file
 Include
-.I file
+.Ar file
 before assembling.
-.TP
-.BI "-I " directory
+.It Fl I Ar directory
 Add
-.I directory
+.Ar directory
 to the include path.
-.TP
-.BI "-D " name [= text ]
+.It Fl D Ar name Op Ns = Ns Ar text
 Define a text macro.
-.SS Code generation
-.TP
-.BI -0 " .. " -10 [ p ]
-Set the target CPU, from 8086 (0, the default) to x86-64 (10).  A trailing
-.B p
+.El
+.Ss Code generation
+.Bl -tag -width Ds
+.It Op Fl 0 ... Fl 10 Op Ar p
+Set the target CPU, from 8086 (0, the default) to x86-64 (10).
+A trailing
+.Ar p
 allows privileged instructions.
-.TP
-.BI -arch SSE | AVX
+.It Fl arch Ar SSE | Ar AVX
 Select the instruction set extensions the macro library generates for.
-.TP
-.BI -G p | c | f | z
+.It Fl G Ar p | Ar c | Ar f | Ar z
 Set the calling convention to Pascal, C, Fastcall or stdcall.
-.TP
-.BI -m t | s | c | m | l | h | f
+.It Fl m Ar t | Ar s | Ar c | Ar m | Ar l | Ar h | Ar f
 Set the memory model.
-.TP
-.BI -Zp [ n ]
+.It Fl Zp Op Ar n
 Set the structure alignment to
-.IR n .
-.TP
-.BI -Sp [ n ]
+.Ar n .
+.It Fl Sp Op Ar n
 Set the segment alignment to
-.IR n .
-.TP
-.B -Zg
+.Ar n .
+.It Fl Zg
 Generate code that matches Masm byte for byte.
-.TP
-.B -nomlib
+.It Fl nomlib
 Do not use the internal macro library.
-.TP
-.B -zcm ", " -zcw
+.It Fl zcm , Fl zcw
 Decorate C names with a leading underscore, or leave them alone.
-.SS Diagnostics
-.TP
-.BI -W level
-Set the warning level, 0 to 4.  The default is 2.
-.TP
-.B -WX
+.El
+.Ss Diagnostics
+.Bl -tag -width Ds
+.It Fl W Ar level
+Set the warning level, 0 to 4.
+The default is 2.
+.It Fl WX
 Treat warnings as errors.
-.TP
-.BI -e number
+.It Fl e Ar number
 Stop after
-.I number
-errors.  The default is 50.
-.TP
-.B -Zs
+.Ar number
+errors.
+The default is 50.
+.It Fl Zs
 Check the syntax only.
-.TP
-.B -eq
+.It Fl eq
 Do not report errors.
-.TP
-.B -q ", " -nologo
+.It Fl q , Fl nologo
 Do not print the version banner.
-.SS Listing contents
-.TP
-.B -EP
+.El
+.Ss Listing contents
+.Bl -tag -width Ds
+.It Fl EP
 Write the preprocessed source to standard output.
-.TP
-.B -Sa
+.It Fl Sa
 Produce a maximal source listing.
-.TP
-.B -Sf
+.It Fl Sf
 List the first pass.
-.TP
-.B -Sg
+.It Fl Sg
 Include the generated code in the listing.
-.TP
-.B -Sn
+.It Fl Sn
 Omit the symbol table from the listing.
-.TP
-.B -Sx
+.It Fl Sx
 List false conditionals.
-.SH ENVIRONMENT
-.TP
-.B INCLUDE
+.El
+.Sh ENVIRONMENT
+.Bl -tag -width Ds
+.It Ev INCLUDE
 A colon separated list of include directories, added to by
-.BR -I .
-.SH EXIT STATUS
-.B uasm
+.Fl I .
+.El
+.Sh EXIT STATUS
+.Nm
 exits with status 0 when every file assembled without an error, and non-zero
 otherwise.
-.SH EXAMPLES
+.Sh EXAMPLES
 Write a freestanding 64-bit Linux program that prints a line, and link it:
-.PP
-.RS
-.nf
+.Bd -literal -offset indent
 $ cat hello.asm
         .code
 PUBLIC _start
@@ -202,11 +183,9 @@ $ uasm -10p -elf64 -Fo hello.o hello.asm
 $ gcc -nostdlib -static -o hello hello.o
 $ ./hello
 hello, world
-.fi
-.RE
-.SH SEE ALSO
-.PP
-.I /usr/share/doc/uasm
-holds the upstream readme, the change log, the licence and the developer
-notes under
-.IR Doc/ .
+.Ed
+.Sh SEE ALSO
+.Pa /usr/share/doc/uasm
+holds the upstream readme, the change log, the licence and the developer 
notes
+under
+.Pa Doc/ .
diff --git a/smgl/smgl-setup/HISTORY b/smgl/smgl-setup/HISTORY
index ad09c05..4b51cda 100644
--- a/smgl/smgl-setup/HISTORY
+++ b/smgl/smgl-setup/HISTORY
@@ -1,3 +1,6 @@
+2026-10-06 Ismael Luceno <ismael AT sourcemage.org>
+       * files/smgl-setup.7: Convert man page to mdoc
+
 2018-04-09 Florian Franzmann <bwlf AT bandrate.org>
        * DEPENDS: depend on MAN instead of man
 
diff --git a/smgl/smgl-setup/files/smgl-setup.7 
b/smgl/smgl-setup/files/smgl-setup.7
index f22ec60..8001a03 100644
--- a/smgl/smgl-setup/files/smgl-setup.7
+++ b/smgl/smgl-setup/files/smgl-setup.7
@@ -1,313 +1,360 @@
 .\" To see this man-page formatted, run it through
-.\" groff -man -Tascii | less -r
+.\" mandoc -Tlint -Tascii | less -r
 .\"
 .\" Change Month, Day, Year to time of editing.
-.TH SMGL-SETUP \
-7 \
-"October 12, 2008" \
-"SMGL User Manual" \
-"Source Mage GNU/Linux User Manual"
-
-.SH NAME
-.B smgl-setup
-- basic introduction to configuring Source Mage GNU/Linux
-
-.SH DESCRIPTION
-.B Welcome to Source Mage GNU/Linux!
-
-This man-page describes the steps that you can/should take for a newly 
installed Source Mage GNU/Linux system. After finishing the minimal 
installation from the ISO itself, there is still a lot of work to be done on 
the part of the user to bring the system to a more usable/polished state. 
This includes configuring the system, setting up networking, etc. Each 
section below will describe different things you can do with your new system.
-
-.SH SYSTEM CONFIGURATION
-The Source Mage installation provides some default settings for a baseline 
system (such as EDITOR=nano). Now would be a good time to configure some of 
those settings to suit your own tastes. Note that you can do these before or 
after updating your system, though it is recommended that you configure some 
of these (such as your text editor and timezone) before doing anything else.
-.\"
-.SS Default Text Editor
-
+.Dd October 12, 2008
+.Dt SMGL-SETUP 7
+.Os "Source Mage GNU/Linux"
+.Sh NAME
+.Nm smgl-setup
+.Nd introduction to configuring Source Mage GNU/Linux
+.Sh DESCRIPTION
+Welcome to Source Mage GNU/Linux!
+.Pp
+This manual describes the steps that you can and should take for a newly
+installed Source Mage GNU/Linux system.
+After finishing the minimal installation from the ISO itself, there is still
+a lot of work to be done on the part of the user to bring the system to a 
more
+usable and polished state.
+This includes configuring the system, setting up networking, and so on.
+Each section below will describe different things you can do with your new
+system.
+.Sh SYSTEM CONFIGURATION
+The Source Mage installation provides some default settings for a baseline
+system, such as
+.Ev EDITOR Ns = Ns Pa nano .
+Now would be a good time to configure some of those settings to suit your own
+tastes.
+Note that you can do this before or after updating your system, though it is
+recommended that you configure some of these, such as your text editor and
+timezone, before doing anything else.
+.Ss Default Text Editor
 You can change the default text editor either globally, by editing the
-.IR /etc/profile.d/editor.sh
+.Pa /etc/profile.d/editor.sh
 script, or per user, by setting the
-.B $EDITOR
+.Ev EDITOR
 environment variable in your
-.I .bashrc
-or equivalent. The default text editor set by the installer is
-.BR nano .
-Make sure that you have your preferred text editor installed else you will 
get errors for trying to use an editor that doesn't exist on your system.
-.\"
-.SS System Logger
-
-You may optionally want to install a system logger. You can have more than 
one logger installed at a time, but you can only have one of them running 
(enabled) at a time or they will conflict with each other. Some spells 
(optionally) depend on having a system logger, so it is recommended that you 
install one. You can view the possible system logging providers by running:
-.IP
-.B gaze provides SYSTEM-LOGGER
-.\"
-.SS /etc/sysconfig/
-
-This directory is full of configuration files that provide different 
settings for your entire system. Some files you might want to edit would be:
-.IP
-.B facilities
-- setup which programs should provide different services such as system 
logging and default display manager
-
-.B hwclock
-- set whether the hardware clock stores time in UTC format
-
-.B keymap
-- sets the keymap to use in the console, as well as the font and whether 
UTF-8 should be enabled or not
-
-.B locale
-- define various locale information
-
-.B init
-- configure the init process, such as the default run level
-
-.B shutdown
-- configure whether to power off or just halt when shutting down
-.\"
-.SS Timezone
-
-You can setup your system's timezone by following these steps. Look for your 
timezone in
-.IR /usr/share/zoneinfo.
+.Pa .bashrc
+or equivalent.
+The default text editor set by the installer is
+.Cm nano .
+Make sure that you have your preferred text editor installed, else you will
+get errors for trying to use an editor that doesn't exist on your system.
+.Ss System Logger
+You may optionally want to install a system logger.
+You can have more than one logger installed at a time, but you can only have
+one of them running (enabled) at a time or they will conflict with each 
other.
+Some spells (optionally) depend on having a system logger, so it is
+recommended that you install one.
+You can view the possible system logging providers by running:
+.Bd -literal -offset indent
+gaze provides SYSTEM-LOGGER
+.Ed
+.Ss Pa /etc/sysconfig/
+This directory is full of configuration files that provide different settings
+for your entire system.
+Some files you might want to edit would be:
+.Bl -tag -width Pa/init
+.It Pa facilities
+Setup which programs should provide different services such as system logging
+and the default display manager.
+.It Pa hwclock
+Set whether the hardware clock stores time in UTC format.
+.It Pa keymap
+Set the keymap to use in the console, as well as the font and whether UTF-8
+should be enabled or not.
+.It Pa locale
+Define various locale information.
+.It Pa init
+Configure the init process, such as the default run level.
+.It Pa shutdown
+Configure whether to power off or just halt when shutting down.
+.El
+.Ss Timezone
+You can set up your system's timezone by following these steps.
+Look for your timezone in
+.Pa /usr/share/zoneinfo .
 Copy or link that timezone to the
-.IR /etc/localtime
-file by running this command as root (using Asia/Manila as an example):
-.IP
-.BR cp " (or" " ln -sf" )
-.I /usr/share/zoneinfo/Asia/Manila /etc/localtime
-.PP
+.Pa /etc/localtime
+file by running this command as root, using
+.Pa Asia/Manila
+as an example:
+.Bd -literal -offset indent
+cp (or ln -sf) /usr/share/zoneinfo/Asia/Manila /etc/localtime
+.Ed
+.Pp
 Verify that everything is working correctly with the
-.BR date (1)
+.Xr date 1
 command.
-
-.SS Networking
-
-Source Mage has recently switched to a simpler system for managing network 
connections using the Debian-based ifupdown interfaces system. This basically 
involves editing the
-.I /etc/network/interfaces
+.Ss Networking
+Source Mage has recently switched to a simpler system for managing network
+connections using the Debian-based ifupdown interfaces system.
+This basically involves editing the
+.Pa /etc/network/interfaces
 file to configure what the
-.BR ifup (8)
+.Xr ifup 8
 and
-.BR ifdown (8)
-commands would do. The
-.BR interfaces (5)
-man page explains how to write the file. Example configurations are also 
provided in the
-.I /usr/share/doc/ifupdown/examples/
+.Xr ifdown 8
+commands would do.
+The
+.Xr interfaces 5
+manual page explains how to write the file.
+Example configurations are also provided in the
+.Pa /usr/share/doc/ifupdown/examples/
 directory, specifically the
-.B network-interfaces
+.Pa network-interfaces
 file.
-
-.SH SYSTEM UPDATE
-
-Once you are able to connect to the Internet, you can start upgrading your 
system to the latest stable versions of the grimoires and sorcery or switch 
to other branches. This is done through the
-.BR scribe (8)
+.Sh SYSTEM UPDATE
+Once you are able to connect to the Internet, you can start upgrading your
+system to the latest stable versions of the grimoires and sorcery, or switch 
to
+other branches.
+This is done through the
+.Xr scribe 8
 and
-.BR sorcery (8)
+.Xr sorcery 8
 commands as described below.
-.\"
-.SS Updating Grimoires
-
+.Ss Updating Grimoires
 A
-.B grimoire
+.Cm grimoire
 is Source Mage's repository of spells and is managed using the
-.BR scribe (8)
-command. By default, only the
-.B stable
-grimoire installed, but the version might be a bit dated by the time you 
have installed Source Mage. The command
-.IP
-.B scribe update
-.PP
-will update all
-.B grimoires
-installed on your system. You can add other
-.B grimoires
-like the
-.B test grimoire
-by running:
-.IP
-.B scribe add test
-.PP
-More information about managing
-.B grimoires
-can be found in the
-.BR scribe (8)
-man page.
-.\"
-.SS Updating Sorcery
-.BR sorcery (8)
-is Source Mage's package management suite. Make sure that it is up-to-date 
by running:
-.IP
-.B sorcery update
-.PP
+.Xr scribe 8
+command.
+By default, only the
+.Cm stable
+grimoire is installed, but the version might be a bit dated by the time you
+have installed Source Mage.
+The command
+.Bd -literal -offset indent
+scribe update
+.Ed
+.Pp
+will update all grimoires installed on your system.
+You can add other grimoires, like the test grimoire, by running:
+.Bd -literal -offset indent
+scribe add test
+.Ed
+.Pp
+More information about managing grimoires can be found in the
+.Xr scribe 8
+manual page.
+.Ss Updating Sorcery
+.Xr sorcery 8
+is Source Mage's package management suite.
+Make sure that it is up-to-date by running:
+.Bd -literal -offset indent
+sorcery update
+.Ed
+.Pp
 You can choose which branch of sorcery to use through the
-.B sorcery
-menu. Run
-.IP
-.B sorcery
-.PP
+.Cm sorcery
+menu.
+Run
+.Bd -literal -offset indent
+sorcery
+.Ed
+.Pp
 and go to the
-.I Option
-menu and then select
-.IR "Sorcery Branch" .
-Be sure to update sorcery every time you switch branches. In case something 
causes the update to fail and your sorcery scripts are lost, run the 
following command to restore them:
-.IP
-.B bash
-.I /root/sorcery.restore
-.\"
-.SS Configuring Sorcery Options
-.B Sorcery
-lets you fine-tune compilation options to your hardware and your personal 
preferences. This is easily done through the
-.BR sorcery (8)
-menu. Run the command
-.IP
-.B sorcery
-.PP
-And go to the
-.B Options
-menu. Here you are presented with a lot of options to customize how sorcery 
functions or how spells are cast. There are a few worth mentioning:
-
-.B Optimize Architecture
-
-Here you will be able to choose a microprocessor category, some pre-defined 
optimization options, as well as additional options that you would want to be 
passed to the compiler.
-
-.B Feature Menu
-
-This lists some Sorcery features which you can toggle on or off. For 
example, you can choose whether Sorcery will create archives of installed 
software or whether to use ccache for accelerated upgrade compilations (
-.B ccache
-must be installed for this to work).
-
-.B Prompt Delay
-
-While casting spells, Sorcery will ask you questions regarding features or 
actions to be taken. It will wait for a given amount of time for you to 
answer before continuing the cast, using the default answer (varies from 
spell to spell) if you don't respond before it times out. This feature allows 
you to set how long, in seconds, Sorcery has to wait before proceeding 
(choose 0 to have sorcery just use the default values immediately - you won't 
be able to change any settings when casting spells if you do this though).
-
-.B Tip:
-The status message at the bottom of the screen gives a brief explanation 
about each option. Feel free to play with various options, but be aware that 
if you don't know what you are doing with some of the options, you could end 
up with drastically different results than you might expect. You can leave 
most settings, besides the compile options, at the default and things should 
run just fine.
-.\"
-.SS Rebuilding the system
-After you have updated your
-.B grimoire(s)
-and
-.B sorcery,
-you may choose to rebuild all the spells installed on your system. This step 
is optional, but recommended. If you choose not to rebuild your system, then 
the options you selected for sorcery will not take effect until the next time 
the spell is compiled (either by forcing a recompile of the spell with:
-.IP
-.B cast -c [spell]
-.PP
-or by upgrading to a new version of the spell). You can rebuild every spell 
in the system by issuing the following command:
-.IP
-.B sorcery rebuild
-.PP
-Optionally, you can first rebuild the toolchain before rebuilding the whole 
system. This will ensure that the toolchain will be using whatever 
optimizations you set in
-.BR sorcery (8)
-when it recompiles the rest of the system. You can rebuild the toolchain by 
running:
-.IP
-.B cast -c binutils gcc g++ gettext glibc
-.PP
-After it's done, you can rebuild the system as indicated above. You can skip 
g++ if you don't have it installed.
-
-.SH BEYOND A BASE INSTALL
-
-You should now have fully working and updated base system, ready to be 
expanded to your personal needs, whether for a desktop, a server, or anything 
else. Where you go from here is really up to you. Add more
-.B grimoires
-with
-.BR scribe (8),
+.Ic Option
+menu, then select
+.Dq Sorcery Branch .
+Be sure to update sorcery every time you switch branches.
+In case something causes the update to fail and your sorcery scripts are
+lost, run the following command to restore them:
+.Bd -literal -offset indent
+bash /root/sorcery.restore
+.Ed
+.Ss Configuring Sorcery Options
+.Xr sorcery 8
+lets you fine-tune compilation options to your hardware and your personal
+preferences.
+This is easily done through the
+.Xr sorcery 8
+menu.
+Run the command
+.Bd -literal -offset indent
+sorcery
+.Ed
+.Pp
+and go to the
+.Cm Options
+menu.
+Here you are presented with a lot of options to customize how sorcery 
functions
+or how spells are cast.
+There are a few worth mentioning:
+.Ss Optimize Architecture
+Here you will be able to choose a microprocessor category, some pre-defined
+optimization options, as well as additional options that you would want to be
+passed to the compiler.
+.Ss Feature Menu
+This lists some Sorcery features which you can toggle on or off.
+For example, you can choose whether Sorcery will create archives of installed
+software, or whether to use ccache for accelerated upgrade compilations.
+Note that
+.Cm ccache
+must be installed for this to work.
+.Ss Prompt Delay
+While casting spells, Sorcery will ask you questions regarding features or
+actions to be taken.
+It will wait for a given amount of time for you to answer before continuing
+the cast, using the default answer (varies from spell to spell) if you don't
+respond before it times out.
+This feature allows you to set how long, in seconds, Sorcery has to wait 
before
+proceeding; choose 0 to have sorcery just use the default values immediately,
+although you won't be able to change any settings while casting spells if you
+do this.
+.Ss Tip
+The status message at the bottom of the screen gives a brief explanation 
about
+each option.
+Feel free to play with various options, but be aware that if you don't know
+what you are doing with some of the options, you could end up with 
drastically
+different results than you might expect.
+You can leave most settings, besides the compile options, at the default and
+things should run just fine.
+.Ss Rebuilding the system
+After you have updated your grimoires and sorcery, you may choose to rebuild
+all the spells installed on your system.
+This step is optional, but recommended.
+If you choose not to rebuild your system, then the options you selected for
+sorcery will not take effect until the next time the spell is compiled, 
either
+by forcing a recompile of the spell with:
+.Bd -literal -offset indent
+cast -c [spell]
+.Ed
+.Pp
+or by upgrading to a new version of the spell.
+You can rebuild every spell in the system by issuing the following command:
+.Bd -literal -offset indent
+sorcery rebuild
+.Ed
+.Pp
+Optionally, you can first rebuild the toolchain before rebuilding the whole
+system.
+This will ensure that the toolchain will be using whatever optimizations you
+set in
+.Xr sorcery 8
+when it recompiles the rest of the system.
+You can rebuild the toolchain by running:
+.Bd -literal -offset indent
+cast -c binutils gcc g++ gettext glibc
+.Ed
+.Pp
+After it's done, you can rebuild the system as indicated above.
+You can skip g++ if you don't have it installed.
+.Sh BEYOND A BASE INSTALL
+You should now have fully working and updated base system, ready to be 
expanded
+to your personal needs, whether for a desktop, a server, or anything else.
+Where you go from here is really up to you.
+Add more grimoires with
+.Xr scribe 8 ,
 search and view spells using
-.BR gaze (1),
+.Xr gaze 1 ,
 or install or remove spells using
-.BR cast (8)
+.Xr cast 8
 and
-.BR dispel (8).
+.Xr dispel 8 .
 Here are a few suggestions you might be interested in.
-.\"
-.SS Command line chatting and surfing
-
-Whether you are a command line type of person, or merely waiting for a 
proper graphical interface to finish casting, you can still enjoy the use of 
your newly set up Internet connection to go online. You can chat on IRC with
-.B irssi
+.Ss Command line chatting and surfing
+Whether you are a command line type of person, or merely waiting for a proper
+graphical interface to finish casting, you can still enjoy the use of your 
newly
+set up Internet connection to go online.
+You can chat on IRC with
+.Cm irssi
 and browse the web with one of many text browsers, such as
-.B w3m,
-.B elinks,
+.Cm w3m ,
+.Cm elinks ,
 or
-.B lynx.
+.Cm lynx .
 For example,
-.IP
-.B cast irssi elinks
-.PP
+.Bd -literal -offset indent
+cast irssi elinks
+.Ed
+.Pp
 will install both
-.B irssi
+.Cm irssi
 and
-.B elinks.
-.\"
-.SS X Window System
-
-Most window managers and desktop environments rely on the X Window System 
for graphical capabilities. If you are using the
-.B stable grimoire,
-you can install (monolithic) Xorg by running
-.IP
-.B cast xorg
-.PP
-On the other hand, if you are using the
-.B test grimoire,
-you can get the newer (modular) Xorg with
-.IP
-.B cast xorg-server
-.PP
-Note that you do not have to manually cast X if you are casting a spell that 
depends on X (such as a window manager or desktop environment), since it will 
automatically be pulled in as a dependency of the spell you are casting that 
depends on it.
-.\"
-.SS DE's and WM's
-
-If you fancy setting up a full graphical environment, Source Mage provides 
spells for most of the major desktop environments and window managers. You 
can install GNOME 1 or 2, KDE 3 or 4, Xfce 4, or a whole host of other window 
managers such as
-.B awesome
+.Cm elinks .
+.Ss X Window System
+Most window managers and desktop environments rely on the X Window System for
+graphical capabilities.
+If you are using the stable grimoire, you can install (monolithic) Xorg by
+running
+.Bd -literal -offset indent
+cast xorg
+.Ed
+.Pp
+On the other hand, if you are using the test grimoire, you can get the newer
+(modular) Xorg with
+.Bd -literal -offset indent
+cast xorg-server
+.Ed
+.Pp
+Note that you do not have to manually cast X if you are casting a spell that
+depends on X, such as a window manager or desktop environment, since it will
+automatically be pulled in as a dependency of the spell you are casting that
+depends on it.
+.Ss DE's and WM's
+If you fancy setting up a full graphical environment, Source Mage provides
+spells for most of the major desktop environments and window managers.
+You can install GNOME 1 or 2, KDE 3 or 4, Xfce 4, or a whole host of other
+window managers such as
+.Cm awesome
 and
-.B fluxbox.
+.Cm fluxbox .
 Most of these are in the
-.B windowmanagers
-section of the
-.B grimoires.
+.Cm windowmanagers
+section of the grimoires.
 To list the spells available in that section, run
-.IP
-.B gaze section windowmanagers
-.PP
+.Bd -literal -offset indent
+gaze section windowmanagers
+.Ed
+.Pp
 The desktop environment spells provide a special
-.I profile
-spell to make it easier to install the whole desktop using just one command. 
These profile spells are as follows:
-.IP
-.B gnome-profile
-- for GNOME 1
-
-.B gnome2-profile
-- for GNOME 2
-
-.B kde-profile
-- for KDE 3
-
-.B kde4-profile
-- for KDE 4
-
-.B xfce4-profile
-- for Xfce 4
-.PP
+.Ic profile
+spell to make it easier to install the whole desktop using just one command.
+These profile spells are as follows:
+.Bl -tag -width Pa/kde4-profile
+.It Pa gnome-profile
+For GNOME 1.
+.It Pa gnome2-profile
+For GNOME 2.
+.It Pa kde-profile
+For KDE 3.
+.It Pa kde4-profile
+For KDE 4.
+.It Pa xfce4-profile
+For Xfce 4.
+.El
+.Pp
 To install one of the desktops, for example Xfce 4, run the command
-.IP
-.B cast xfce4-profile
-.PP
-.B Note about KDE 4:
+.Bd -literal -offset indent
+cast xfce4-profile
+.Ed
+.Pp
+.Em Note about KDE 4:
 In order for a user to be able to use KDE 4, that user must belong to the
-.I kde4
-group. Add a user to the kde4 group with this command:
-.IP
-.B gpasswd -a [username] kde4
-.PP
-.\"
+.Pa kde4
+group.
+Add a user to the kde4 group with this command:
+.Bd -literal -offset indent
+gpasswd -a [username] kde4
+.Ed
 .\" The following commands should be uncommented and
 .\" used where appropriate.
 .\" This next command is for sections 1, 6, 7 and 8 only.
-.\" .SH ENVIRONMENT
-.\" .SH FILES
-.\" .SH EXAMPLES
-.\"
-.SH SEE ALSO
-.BR scribe (8), \ sorcery (8), \ gaze (1), \ cast (8), \ dispel (8)
-.PP
+.\" .Sh ENVIRONMENT
+.\" .Sh FILES
+.\" .Sh EXAMPLES
+.Sh SEE ALSO
+.Xr scribe 8 ,
+.Xr sorcery 8 ,
+.Xr gaze 1 ,
+.Xr cast 8 ,
+.Xr dispel 8
+.Pp
 Visit the Source Mage GNU/Linux website:
-.I http://www.sourcemage.org
-.\"
-.\" .SH STANDARDS
-.\" .SH HISTORY
-.\"
-.SH AUTHORS
+.Lk http://www.sourcemage.org
+.\" .Sh STANDARDS
+.\" .Sh HISTORY
+.Sh AUTHORS
 The Tome and Cauldron Teams of Source Mage GNU/Linux
-.\"
-.\" .SH BUGS
+.\" .Sh BUGS
\ No newline at end of file