diff --git a/ja_JP.eucJP/man/man5/Makefile b/ja_JP.eucJP/man/man5/Makefile index 3b217f908f..57eeea1307 100644 --- a/ja_JP.eucJP/man/man5/Makefile +++ b/ja_JP.eucJP/man/man5/Makefile @@ -1,124 +1,125 @@ # $FreeBSD$ MAN5 = a.out.5\ acct.5\ aliases.5\ amd.conf.5\ auth.conf.5\ bootparams.5\ bootptab.5\ core.5\ config.5\ crontab.5\ ctm.5\ cvs.5\ devd.conf.5\ devfs.5\ device.hints.5\ dhclient.conf.5\ dhclient.leases.5\ dhcp-eval.5\ dhcp-options.5\ dir.5\ disktab.5\ drivers.conf.5\ editrc.5\ elf.5\ ethers.5\ exports.5\ fbtab.5\ fdescfs.5\ finger.conf.5\ forward.5\ fs.5\ fstab.5\ ftpchroot.5\ gettytab.5\ groff_font.5\ groff_out.5\ groff_tmac.5\ group.5\ hosts.5\ hosts.equiv.5\ hosts.lpd.5\ hosts_access.5\ hosts_options.5\ info.5\ intro.5\ ipf.5\ ipnat.5\ ipsend.5\ isdnd.acct.5\ isdnd.rates.5\ isdnd.rc.5\ kbdmap.5\ keycap.5\ link.5\ linprocfs.5\ loader.conf.5\ login.access.5\ login.conf.5\ magic.5\ mailer.conf.5\ make.conf.5\ motd.5\ msdosfs.5\ named.conf.5\ netconfig.5\ netgroup.5\ netid.5\ networks.5\ nologin.5\ ntp.conf.5\ ntp.keys.5\ opieaccess.5\ opiekeys.5\ passwd.5\ pbm.5\ pccard.conf.5\ periodic.conf.5\ phones.5\ printcap.5\ procfs.5\ protocols.5\ publickey.5\ pw.conf.5\ radius.conf.5\ rc.conf.5\ rcsfile.5\ remote.5\ resolver.5\ rpc.5\ rrenumd.conf.5\ rtadvd.conf.5\ services.5\ shells.5\ ssh_config.5\ sshd_config.5\ stab.5\ + style.Makefile.5\ sysctl.conf.5\ syslog.conf.5\ tacplus.conf.5\ term.5\ termcap.5\ terminfo.5\ texinfo.5\ ttys.5\ tzfile.5\ usbd.conf.5\ utmp.5\ uuencode.format.5\ vgrindefs.5 MLINKS+=kbdmap.5 keymap.5 MLINKS+=utmp.5 lastlog.5 utmp.5 wtmp.5 MLINKS+=hosts.equiv.5 rhosts.5 MLINKS+=uuencode.format.5 uuencode.5 MLINKS+=resolver.5 resolv.conf.5 MLINKS+=fs.5 inode.5 MLINKS+=dir.5 dirent.5 MLINKS+=groff_tmac.5 tmac.5 MLINKS+=ipnat.5 ipnat.conf.5 MLINKS+=passwd.5 master.passwd.5 MLINKS+=msdosfs.5 msdos.5 .include "bsd.prog.mk" diff --git a/ja_JP.eucJP/man/man5/style.Makefile.5 b/ja_JP.eucJP/man/man5/style.Makefile.5 new file mode 100644 index 0000000000..6443f9fcfe --- /dev/null +++ b/ja_JP.eucJP/man/man5/style.Makefile.5 @@ -0,0 +1,254 @@ +.\" Copyright (c) 2002-2003 David O'Brien +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. Neither the name of the author nor the names of any contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL DAVID O'BRIEN OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %FreeBSD: src/share/man/man5/style.Makefile.5,v 1.7 2003/09/08 19:57:20 ru Exp % +.\" $FreeBSD$ +.\" +.Dd February 28, 2003 +.Dt STYLE.MAKEFILE 5 +.Os +.Sh 名称 +.Nm style.Makefile +.Nd +.Fx +における +.Pa Makefile +ファイルのスタイルガイド +.Sh 解説 +このファイルは +.Fx +ソースツリーの makefile に好ましいスタイルを明記しています。 +.Bl -bullet +.It +全ての makefile はファイルの先頭に SCM ID を持ち、それに空行が続きます。 +.Bd -literal +# $FreeBSD\&$ + +.Ed +.It +必要ならば、次に +.Cm .PATH : +が続きます。 +.Dq Li ".PATH: " +のように、コロンの後に単一の +.Tn アスキー +スペースが続くように綴ります。 +.Va VPATH +変数は使わないでください。 +.It +特殊変数 ( +.Va LIB 、 SRCS 、 MLINKS +など) は、作成されるもの、バイナリの構築に使うもの、 +バイナリのインストールに使うものの順番で並べます (「作成物順」)。 +あるいは構築される順番、つまり主となるプログラム (あるいはライブラリ) に +使うものが先にくるように並べても構いません (「構築物順」)。 +一般的な「作成物順」はこうです: +.Va PROG Ns / Ns Va LIB Ns / Ns Va SCRIPT +.Va FILES +.Va LINKS +.Oo Va NO Oc Ns Va MAN +.Va MLINKS +.Va INCS +.Va SRCS +.Va WARNS +.Va CFLAGS +.Va DPADD +.Va LDADD 。 +一般的な「構築物順」はこうです: +.Va PROG Ns / Ns Va LIB Ns / Ns Va SCRIPT +.Va SRCS +.Va WARNS +.Va CFLAGS +.Va DPADD +.Va LDADD +.Va INCS +.Va FILES +.Va LINKS +.Oo Va NO Oc Ns Va MAN +.Va MLINKS 。 +.It +.In bsd.prog.mk +を使い、 +.Va PROG +と同じ名前の単一のソースファイルである場合は、 +.Va SRCS +を省略します。 +.It +.In bsd.prog.mk +を使い、 +.Va PROG +と同じ名前で、セクション 1 のマニュアルページである時は、 +.Va MAN +を省略します。 +.It +変数への代入はすべて +.Dq Va VAR Ns Ic = +のように綴ります。 +つまり、変数名と +.Ic = +の間には空白を置きません。 +可能ならば、値はアルファベット順にソートするようにします。 +.It +変数を一回だけ設定する +(もしくは変数を最初に設定する) +場合に、 +.Ic += +を使うのはやめてください。 +.It +簡単な makefile で、空行を使うのはやめてください。 +しかしより複雑で長いものに対しては、部分的に関連する項目を +まとめるために使います。 +.It +基本的に +.Va WARNS +は +.Va CFLAGS +の修飾子ですが、 +.Va CFLAGS +の前に置きます。 +.Va WARNS +は重要なものであり、大量の +.Va CFLAGS +の記述の中で見失わないように、 +.Va CFLAGS +の後ろではなくて、 +.Va CFLAGS +の前に置きます。 +コマンドラインや +.Pa /etc/make.conf +で上書きできるように、 +.Va WARNS +は +.Dq Li "WARNS?= " +のように綴ります。 +.It +.Dq Li "NO_WERROR= yes" +は使うべきでありません。これは +.Va WARNS +の目的を無効にしてしまいます。 +これはコマンドラインで、かつ特殊な状況でのみ使用されるべきです。 +.It +.Va CFLAGS +は +.Dq Li "CFLAGS+= " +のように綴ります。 +.It +.Va CFLAGS +において、 +.Fl I +の前に +.Fl D +のリストを置くのは、アルファベット順という点からも、また +.Fl D +を見やすくする点からも好ましいことです。 +.Fl D +はしばしば条件つきのコンパイルに影響し、また +.Fl I +は意外に長くなりがちです。 +長い +.Va CFLAGS +の設定では +.Fl D +と +.Fl I +の間で分割します。 +.It +.Va CFLAGS +において、 GCC 的なもの ( +.Fl g +や +.Fl Wall +といったもの) +を使うのはやめましょう。 +.It +一般的には +.Va VAR Ns Ic = +と値の間に、 +.Tn アスキー +タブをひとつ入れます。 +値が 9 桁目から始まるようにするためです。 +変数名が 9 桁を超える場合は、単一の +.Tn アスキー +スペースで良いです。 +また変数名がとても長い場合は、ホワイトスペース無しでも良いです。 +.It +.Ic .include In bsd.*.mk +は最後です。 +.It +.Va $< +や、 +.Va $@ +といった時代錯誤のものを使うのはやめましょう。 +代わりに +.Va ${.IMPSRC} +か +.Va ${.ALLSRC} +、それと +.Va ${.TARGET} +を使います。 +.El +.Pp +論理的なグループ分けを表現したいために、 +上記のいくつかに従わないこともしばしばあります。 +.Sh 使用例 +最もシンプルな、プログラムの +.Pa Makefile +です: +.Bd -literal -offset indent +# $FreeBSD\&$ + +PROG= foo + +\&.include +.Ed +.Pp +最もシンプルな、ライブラリの +.Pa Makefile +です: +.Bd -literal -offset indent +# $FreeBSD\&$ + +LIB= foo +SHLIB_MAJOR= 1 +MAN= libfoo.3 +SRCS= foo.c + +\&.include +.Ed +.Sh 関連項目 +.Xr make 1 , +.Xr style 9 +.Sh 歴史 +このマニュアルページは、 +.Fx +の +.Xr style 9 +マニュアルページと同じソースに影響されています。 +.Sh バグ +例外を許さないスタイル規則は、ほとんどありません。 +多くのスタイルは、 makefile 全体の内容、あるいはその前後の行に +強く依存しています。