From owner-freebsd-questions@FreeBSD.ORG  Mon Jan 30 23:15:05 2012
Return-Path: <owner-freebsd-questions@FreeBSD.ORG>
Delivered-To: freebsd-questions@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id A1324106564A
	for <freebsd-questions@freebsd.org>;
	Mon, 30 Jan 2012 23:15:05 +0000 (UTC)
	(envelope-from janixsoft@gmail.com)
Received: from mail-tul01m020-f182.google.com (mail-tul01m020-f182.google.com
	[209.85.214.182])
	by mx1.freebsd.org (Postfix) with ESMTP id 59F298FC1A
	for <freebsd-questions@freebsd.org>;
	Mon, 30 Jan 2012 23:15:05 +0000 (UTC)
Received: by obcwo16 with SMTP id wo16so6855138obc.13
	for <freebsd-questions@freebsd.org>;
	Mon, 30 Jan 2012 15:15:04 -0800 (PST)
Received-SPF: pass (google.com: domain of janixsoft@gmail.com designates
	10.182.222.74 as permitted sender) client-ip=10.182.222.74; 
Authentication-Results: mr.google.com;
	spf=pass (google.com: domain of janixsoft@gmail.com
	designates 10.182.222.74 as permitted sender)
	smtp.mail=janixsoft@gmail.com;
	dkim=pass header.i=janixsoft@gmail.com
Received: from mr.google.com ([10.182.222.74])
	by 10.182.222.74 with SMTP id qk10mr52391269obc.75.1327965304741
	(num_hops = 1); Mon, 30 Jan 2012 15:15:04 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma;
	h=mime-version:reply-to:date:message-id:subject:from:to:content-type;
	bh=Za5t36c4lXa2PR3znGdc6yjkfSLU6t9TfncPTDvJgqg=;
	b=V9UMvAcGv72NquZ6JMroZV6oybjv+kBa450LaUeuryNL5xng71Ago/ogSeqv2yYv4T
	dAWkSy8dDEdkRMIDudPz0Xtgl87hNX3HP1ZFtFm/jhpvONt2SF5Zqo3FtJJrjg+kiRub
	ZNigCW/9cYFHac9Qvs5ld1vmUhn2eNybOdgBc=
MIME-Version: 1.0
Received: by 10.182.222.74 with SMTP id qk10mr32180546obc.75.1327963468261;
	Mon, 30 Jan 2012 14:44:28 -0800 (PST)
Received: by 10.60.47.166 with HTTP; Mon, 30 Jan 2012 14:44:28 -0800 (PST)
Date: Mon, 30 Jan 2012 17:44:28 -0500
Message-ID: <CAOfTqFMtFLfS8nisQRp3KyKBSoQdFCCWgTUJNMB9FrkNha+u3A@mail.gmail.com>
From: Jason Massey <janixsoft@gmail.com>
To: freebsd-questions@freebsd.org
Content-Type: text/plain; charset=ISO-8859-1
X-Content-Filtered-By: Mailman/MimeDel 2.1.5
Subject: What is the FreeBSD mdoc (man) to HTML toolchain?
X-BeenThere: freebsd-questions@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
Reply-To: Jason@JanixSoft.com
List-Id: User questions <freebsd-questions.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-questions>, 
	<mailto:freebsd-questions-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-questions>
List-Post: <mailto:freebsd-questions@freebsd.org>
List-Help: <mailto:freebsd-questions-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-questions>, 
	<mailto:freebsd-questions-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Mon, 30 Jan 2012 23:15:05 -0000

Dear FreeBSD masters:

I am looking to understand the toolchain that begins with an mdoc-based
manual page and ends with a nice HTML file (as illustrated by
http://www.freebsd.org/cgi/man.cgi?query=groff_mdoc&apropos=0&sektion=0&manpath=FreeBSD+9.0-RELEASE&arch=default&format=html
).


Hypothetically, were I personally attempting to convert the `groff_mdoc.7'
manual page to HTML, from what I've researched the command should be:

groff -mdoc -Thtml groff_mdoc.7 | tidy > bsdgroff.html



[1]
Is the above command how the FreeBSD project produces its gorgeous HTML man
pages?

[2]
How does one associate a <link .../> CSS stylesheet with the resultant
file? I cannot locate a `groff' command switch to stop it from inserting
its own inline style information.



== Research I've performed:

I have read GROFF_MDOC(7) in its entirety.

I have searched GROFF(1) and groff's [Tex]info document.



Most respectfully,

Jason