		Sambaドキュメントの日本語訳版について

						2017/10/13
						日本Sambaユーザー会


1. はじめに
======================================================================

1.1 概要
----------------------------------------------------------------------

ここにあるファイルは、Sambaのドキュメントを日本語訳したファイルです。
訳していないものについては、英語版をそのまま取り込んでいます。
Samba-JP MLとsugj-tech MLのメンバーのご協力のもとに、多くの修正を行ない
ましたが、訳についてはまだまだ不十分なところが多数あります。そのことを
ご理解の上、ご利用ください。

1.2 リリース形式
----------------------------------------------------------------------

3.5系列からは、man形式、HTML形式およびSamba3-HOWTO、Samba3-Developers-Guideを
1つのアーカイブとして提供するほか、man形式のみのファイルも提供します。
man形式のみのアーカイブでは、再構築は出来ません。

2. バク
======================================================================

 かなり見直しましたが、まだまだ潜んでいるはずです。細かな検証を行なって
おりません。また、一部の部分はオリジナルと併記してある箇所があります。
誤訳等がありましたら、日本Sambaユーザー会のメーリングリスト(samba-jp@
samba.gr.jp)かスタッフまでご連絡ください。

3. 利用にあたって
======================================================================

3.1 配布について
----------------------------------------------------------------------

配布については、Sambaの配布条件と同じです(GPLv3)。同梱している
COPYINGファイルを参照してください。また、いくつかの補助的な
ファイルなども同梱しています。

3.2 更新条件
----------------------------------------------------------------------

原則として、オリジナルSambaが更新対象となっているものについて
翻訳を行います。

・4.3.x系列以前:	翻訳終了
・4.4.x系列:		翻訳中(限定対応)
・4.5.x系列:		翻訳中
・4.6.x系列:		翻訳中
・4.7.x系列:		翻訳中


Sambaのバージョンが変更になってもドキュメントの修正がない場合には、
日本語訳は変更しません。その場合にはSambaの旧バージョンに対応した
日本語マニュアルをそのままお使いください。更新状況については、
日本Sambaユーザー会のWebページか、Samba-JPメーリングリストを参照
してください。

なお、4.4.x系列はSambaコミュニテイではEOLになっていますが、Red Hat
Enterprise Linux等で使われているバージョンのため、誤字や誤翻訳につい
てのみ、当面メンテナンスを行います。

3.3 文字コード
----------------------------------------------------------------------

HTML形式、およびman形式のファイル両方ともUTF-8でエンコードしています。
必要に応じて他の文字コードに変換してください。

4. ビルド方法
======================================================================
4.1 準備

(1) 必要なパッケージの事前インストール

Sambaドキュメント（日本語訳版）をビルドするためには、最小でも以下の
パッケージが必要となります。事前にインストールしてください。
  make, autoconf, docbook-xml, docbook-xsl, xsltproc(または libxslt),
  inkscape

・パッケージ名は一般的な名称で示しています。ディストリビューション
  によっては名称が若干異なるかもしれません。

・docbook-xml, docbook-xsl はオリジナルの README には記載されて
  いないパッケージです。これらはインストールしておくことをお勧め
  します。これがない場合、xsltproc 処理において、DTD ファイルや
  xsl スタイルファイルをネットワーク経由で取得しにいくため、処理
  に時間を要するためです。

・inkscape は make html を実行しないのであれば不要です。

上述のパッケージのインストールにより、後述する make のターゲット、
manpages、html、htmlman が実行可能になります。これ以外にも make
ターゲットがありますが、当プロジェクトは現時点では対応していません。

(2) Samba ソースアーカイブファイルを 任意のディレクトリに展開

  $ cd /srv/build
  $ tar xzf /srv/source/samba-4.X.Y.tar.gz

(3) Samba 翻訳文書アーカイブファイルを任意の場所に展開

  $ cd /srv/build
  $ mkdir samba-ja-docs-4.X.Y-Z
  $ cd /srv/source/samba-ja-docs-4.X.Y-Z
  $ tar xzf samba-ja-docs-4.X.Y-Z.tar.gz

(4) configure を実行; --with-sambadir を用いて Samba ソースディレクトリを指定

  $ cd /srv/source/samba-ja-docs-4.X.Y-Z/docs-xml
  $ ./configure --with-sambadir=/srv/build/samba-4.X.Y
  または
  $ ./configure --with-sambadir=../../../samba-4.X.Y

4.2 ビルドを実行

  $ make clean
  $ make manpages (manpagesの作成)
  $ make htmlman  (html化したmanpagesの作成)
  $ make html     (Samba3-HOWTO等のhtml文書の作成)


5. 変更履歴
======================================================================

2016/06/19 Ver 4.4.4-1 4.4.4対応
		     build/DTD/samba-doc,
		     idmap_autorid.8.xml,idmap_rfc2307.8.xml,
		     net.8.xml,ntlm_auth.1.xml,pdbedit.8.xml,
		     vfs_fruit.8.xml,vfs_ceph.8.xml,vfs_shadow_copy2.8.xml
		     base/doscharset.xml,base/interfaces.xml,
		     base/netbiosaliases.xml,base/netbiosname.xml,
		     base/realm.xml,base/unixcharset.xml,
		     base/workgroup.xml,
		     browse/domainmaster.xml,browse/lmannounce.xml,
		     browse/preferredmaster.xml,
		     domain/allowdnsupdates.xml,domain/dnsupdatecommand.xml,
		     domain/machinepasswordtimeout.xml,
		     domain/nsupdatecommand.xml,domain/rndccommand.xml,
		     domain/spnupdatecommand.xml,
		     filename/casesensitive.xml,filename/defaultcase.xml,
		     ldap/clientldapsaslwrapping.xml,ldap/ldapderef.xml,
		     ldap/ldapfollowreferral.xml,ldap/ldapgroupsuffix.xml,
		     ldap/ldapidmapsuffix.xml,ldap/ldapmachinesuffix.xml,
		     ldap/ldappagesize.xml,ldap/ldappasswdsync.xml,
		     ldap/ldapssl.xml,
		     locking/cscpolicy.xml,locking/strictlocking.xml,
		     logging/ldapdebuglevel.xml,logging/logfile.xml,
		     logging/syslog.xml,logging/syslogonly.xml,
		     logon/enableprivileges.xml,logon/initlogondelayedhosts.xml,
		     misc/copy.xml,misc/fstype.xml,misc/include.xml,
		     misc/nbtclientsocketaddress.xml,
		     misc/usershareprefixallowlist.xml,
		     misc/usershareprefixdenylist.xml,misc/valid.xml,
		     misc/widelinks.xml,
		     printing/cupsencrypt.xml,printing/enablespoolss.xml,
		     printing/maxprintjobs.xml,printing/printcapname.xml,
		     printing/printing.xml,
		     protocol/aclcheckpermissions.xml,
		     protocol/clientmaxprotocol.xml,
		     protocol/clientminprotocol.xml,
		     protocol/clientusespnego.xml,protocol/eventloglist.xml,
		     protocol/readraw.xml,protocol/servermaxprotocol.xml,
		     protocol/smb2maxcredits.xml,protocol/smb2maxread.xml,
		     protocol/smb2maxtrans.xml,protocol/smb2maxwrite.xml,
		     protocol/smbports.xml,protocol/svcctllist.xml,
		     protocol/writeraw.xml,
		     security/clientntlmv2auth.xml,security/clientschannel.xml,
		     security/clientsigning.xml,
		     security/clientusepsnegoprincipal.xml
		     security/createmask.xml,security/directorymask.xml,
		     security/forcecreatemode.xml,
		     security/forcedirectorymode.xml,security/hostsallow.xml,
		     security/hostsdeny.xml,security/kerberosmethod.xml,
		     security/maptoguest.xml,security/nullpasswords.xml,
		     security/onlyuser.xml,security/preloadmodules.xml,
		     security/sambakcccommand.xml,security/security.xml,
		     security/serverrole.xml,security/serverschannel.xml,
		     security/serversigning.xml,security/smbencrypt.xml,
		     security/username.xml,security/writeable.xml,
		     tuning/aioreadsize.xml,tuning/aiowritesize.xml,
		     tuning/allocationroundupsize.xml,tuning/blocksize.xml,
		     tuning/maxdisksize.xml,tuning/strictrename.xml,
		     tuning/strictsync.xml,tuning/writecachesize.xml,
		     vfs/vfsobjects.xml,
		     winbind/idmapbackend.xml,winbind/idmapconfig.xml,
		     winbind/idmapgid.xml,winbind/idmapuid.xml,
		     winbind/winbindmaxdomainconnections.xml,
		     winbind/winbindnssinfo.xml,
		     wins/winsserver.xml
		     修正
		     cifsdd.8.xml,vfs_offline.8.xml,
		     logging/timestamplogs.xml,misc/auto_services.xml,
		     protocol/servermultichannelsupport.xml,
		     tuning/aioreadsize.xml
		     追加
		     vfs_scannedonly.8.xml,vfs_smb_traffic_analyzer.8.xml,
		     logging/debugtimestamp.xml,
		     misc/preload.xml
		     削除

2016/10/24 Ver 4.5.0-1 4.5.0対応
	       	     idmap_script.8.xml,libsmbclient.7.xml,idmap_script.8.xml,
		     ntlm_auth.1.xml,samba-tool.8.xml,smbclient.1.xml,
		     smbspool.8.xml,vfs_acl_tdb.8.xml,vfs_acl_xattr.8.xml,
		     vfs_fruit.8.xml,vfs_glusterfs.8.xml,vfs_gpfs.8.xml,
		     vfs_tsmsm.8.xml,
		     domain/dnsforwarder.xml,ldap/ldapssl.xml,
		     locking/smb2leases.xml,protocol/dcerpcendpointservers.xml,
		     security/checkpasswordscript.xml,
		     security/ntlmauth.xml,security/unixpasswordsync.xml
		     修正
		     security/passwordhashgpgkeyids.xml
		     追加
		     security/onlyuser.xml,security/unixpasswordsync.xml 
		     削除

2016/10/28 Ver 4.4.7-1 4.4.7対応
	       	     vfs_acl_xattr.8.xml
		     修正

2017/10/13 Ver 4.4.16-1 4.4.16対応
	       	     makefile修正等、lang="ja"対応
		     aclocal.m4,configure,configure.ac,Makefile.in,
		     Makefile.settings.in,
		     xslt/local.ja.xml,xslt/sj.html-common.xsl,
		     xslt/sj.man.xsl
		     追加
		     makefile,htmlconv.php
		     削除
		     cifsdd.8.xml,lmhosts.5.xml,vfs_fruit.8.xml,
		     logon/logonscript.xml,misc/cachedirectory.xml,
		     misc/fssprunestale.xml,misc/fsssequencetimeout.xml,
		     misc/lockdirectory.xml,misc/resetonzerovc.xml,
		     misc/rpcdaemon.xml,misc/statedirectory.xml,
		     security/checkpasswordscript.xml,security/security.xml
		     修正
======================================================================

翻訳者は、当訳文の正当性、信頼性、先進性、妥当性、可読性、その他いかなるこ
とについて責任を負いません。
 
7.ご協力いただいた方々(順不同)
======================================================================

  佐藤文優,太田俊哉,千秋広幸,山口一郎,中野武雄,細川達己,たかはしもとのぶ、
  堀田倫英,武田保真,でん,山田史朗,はせがわようすけ,ちかましゅうへい,
  しらいたかし,平田祥司、海老澤、Michio Matsuyama
  Samba-JP/sugj-tech メーリングリストのメンバー
  (有)トップスタジオ/(株)翔泳社
