From owner-freebsd-doc@FreeBSD.ORG  Thu Nov 18 04:38:08 2004
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 2A7EA16A4CE
	for <doc@freebsd.org>; Thu, 18 Nov 2004 04:38:08 +0000 (GMT)
Received: from rproxy.gmail.com (rproxy.gmail.com [64.233.170.194])
	by mx1.FreeBSD.org (Postfix) with ESMTP id CAD5943D1F
	for <doc@freebsd.org>; Thu, 18 Nov 2004 04:38:07 +0000 (GMT)
	(envelope-from joseph.koshy@gmail.com)
Received: by rproxy.gmail.com with SMTP id b11so1006120rne
        for <doc@freebsd.org>; Wed, 17 Nov 2004 20:38:02 -0800 (PST)
DomainKey-Signature: a=rsa-sha1; q=dns; c=nofws;
	s=beta; d=gmail.com;
	h=received:message-id:date:from:reply-to:to:subject:cc:in-reply-to:mime-version:content-type:content-transfer-encoding:references;
	b=ekxIRc2KbN9/G6ICn/r3HiuqHoKck2DdL8WhuwsmUPwIR9jV6nkmC55TmfobZfXDQVICsePUKXE0o+c13WXIyg2cUGqk/9Ip+zov7Kw6boydLl9iuFC/2daMcpSj2izvArEFzanltXc3hTX2FMo5Hqkw3SGQLpkTffc0fCmv/e4=
Received: by 10.38.162.54 with SMTP id k54mr85849rne;
        Wed, 17 Nov 2004 20:38:02 -0800 (PST)
Received: by 10.38.13.37 with HTTP; Wed, 17 Nov 2004 20:37:59 -0800 (PST)
Message-ID: <84dead7204111720374b93595c@mail.gmail.com>
Date: Thu, 18 Nov 2004 10:07:59 +0530
From: Joseph Koshy <joseph.koshy@gmail.com>
To: Alexey Dokuchaev <danfe@nsu.ru>
In-Reply-To: <20041117155141.GA54101@regency.nsu.ru>
Mime-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit
References: <20041117115501.GA81934@regency.nsu.ru>
	 <84dead7204111704502a0b6765@mail.gmail.com>
	 <20041117155141.GA54101@regency.nsu.ru>
cc: doc@freebsd.org
Subject: Re: .so macro in man pages
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
Reply-To: Joseph Koshy <joseph.koshy@gmail.com>
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Thu, 18 Nov 2004 04:38:08 -0000

> like to know why the latter method didn't work for me as expected, just
> for the reference.

man -d will report the exact command line used to generate the manual
page.

   $ man -d -M /tmp/man bar 
   trying command: (cd /tmp/man ; /usr/bin/zcat /tmp/man/man1/bar.1.gz
| /usr/bin/tbl | /usr/bin/groff -S -Wall -mtty-char -man -Tascii |
/usr/bin/col | /usr/bin/less)

  $ gzip -dc man1/bar.1.gz
  .so man2/foo.2

However the man2/ directory only contains the gzipped version of the manual
page.  Consequently the .so include by groff will fail.

  $ man -M /tmp/man bar
  <standard input>:1: can't open `man2/foo.2': No such file or directory