PERFORCE change 102628 for review
John Birrell
jb at FreeBSD.org
Fri Jul 28 03:08:06 UTC 2006
http://perforce.freebsd.org/chv.cgi?CH=102628
Change 102628 by jb at jb_freebsd2 on 2006/07/28 03:07:22
IFC
Affected files ...
.. //depot/projects/dtrace/doc/en_US.ISO8859-1/articles/contributors/contrib.additional.sgml#17 integrate
.. //depot/projects/dtrace/doc/en_US.ISO8859-1/books/porters-handbook/book.sgml#15 integrate
.. //depot/projects/dtrace/doc/share/sgml/man-refs.ent#10 integrate
.. //depot/projects/dtrace/doc/zh_TW.Big5/books/developers-handbook/book.sgml#2 integrate
.. //depot/projects/dtrace/doc/zh_TW.Big5/books/developers-handbook/introduction/chapter.sgml#2 integrate
.. //depot/projects/dtrace/doc/zh_TW.Big5/books/developers-handbook/tools/chapter.sgml#2 integrate
.. //depot/projects/dtrace/doc/zh_TW.Big5/share/sgml/authors.ent#1 branch
.. //depot/projects/dtrace/doc/zh_TW.Big5/share/sgml/catalog#2 integrate
.. //depot/projects/dtrace/doc/zh_TW.Big5/share/sgml/l10n.ent#2 integrate
.. //depot/projects/dtrace/doc/zh_TW.Big5/share/sgml/trademarks.ent#2 integrate
.. //depot/projects/dtrace/ports/GIDs#2 integrate
.. //depot/projects/dtrace/ports/MOVED#7 integrate
.. //depot/projects/dtrace/ports/Mk/bsd.php.mk#3 integrate
.. //depot/projects/dtrace/ports/Mk/bsd.scons.mk#4 integrate
.. //depot/projects/dtrace/ports/Mk/bsd.sites.mk#4 integrate
.. //depot/projects/dtrace/ports/UIDs#2 integrate
.. //depot/projects/dtrace/ports/UPDATING#7 integrate
.. //depot/projects/dtrace/src/UPDATING#5 integrate
.. //depot/projects/dtrace/src/bin/sh/sh.1#3 integrate
.. //depot/projects/dtrace/src/bin/test/test.1#3 integrate
.. //depot/projects/dtrace/src/etc/rc.d/ipfw#3 integrate
.. //depot/projects/dtrace/src/etc/rc.d/mdconfig#2 integrate
.. //depot/projects/dtrace/src/etc/rc.d/mdconfig2#2 integrate
.. //depot/projects/dtrace/src/etc/rc.d/natd#3 integrate
.. //depot/projects/dtrace/src/etc/rc.subr#7 integrate
.. //depot/projects/dtrace/src/gnu/usr.bin/binutils/ld/Makefile.alpha#3 integrate
.. //depot/projects/dtrace/src/gnu/usr.bin/binutils/ld/Makefile.amd64#3 integrate
.. //depot/projects/dtrace/src/gnu/usr.bin/binutils/ld/Makefile.arm#1 branch
.. //depot/projects/dtrace/src/gnu/usr.bin/binutils/ld/Makefile.i386#3 integrate
.. //depot/projects/dtrace/src/gnu/usr.bin/binutils/ld/Makefile.ia64#3 integrate
.. //depot/projects/dtrace/src/gnu/usr.bin/binutils/libbfd/Makefile.arm#1 branch
.. //depot/projects/dtrace/src/gnu/usr.bin/binutils/libopcodes/Makefile.arm#1 branch
.. //depot/projects/dtrace/src/gnu/usr.bin/cc/cc_tools/auto-host.h#3 integrate
.. //depot/projects/dtrace/src/gnu/usr.bin/gdb/kgdb/trgt_arm.c#1 branch
.. //depot/projects/dtrace/src/lib/libc/gen/tls.c#3 integrate
.. //depot/projects/dtrace/src/lib/libc/net/Makefile.inc#4 integrate
.. //depot/projects/dtrace/src/lib/libc/net/getaddrinfo.c#5 integrate
.. //depot/projects/dtrace/src/lib/libc/net/name6.c#5 integrate
.. //depot/projects/dtrace/src/lib/libc/stdlib/malloc.c#5 integrate
.. //depot/projects/dtrace/src/lib/libc/sys/Symbol.map#2 integrate
.. //depot/projects/dtrace/src/lib/libfetch/Makefile#3 integrate
.. //depot/projects/dtrace/src/lib/libftpio/Makefile#3 integrate
.. //depot/projects/dtrace/src/lib/libkvm/kvm_proc.c#4 integrate
.. //depot/projects/dtrace/src/lib/libmemstat/memstat.h#4 integrate
.. //depot/projects/dtrace/src/lib/libthr/pthread.map#4 integrate
.. //depot/projects/dtrace/src/lib/libthr/thread/thr_init.c#6 integrate
.. //depot/projects/dtrace/src/lib/libthr/thread/thr_sig.c#3 integrate
.. //depot/projects/dtrace/src/lib/libthr/thread/thr_syscalls.c#3 integrate
.. //depot/projects/dtrace/src/lib/libutil/Makefile#4 integrate
.. //depot/projects/dtrace/src/libexec/rlogind/Makefile#3 integrate
.. //depot/projects/dtrace/src/libexec/telnetd/Makefile#3 integrate
.. //depot/projects/dtrace/src/release/doc/en_US.ISO8859-1/hardware/common/dev.sgml#6 integrate
.. //depot/projects/dtrace/src/release/doc/en_US.ISO8859-1/relnotes/common/new.sgml#13 integrate
.. //depot/projects/dtrace/src/release/doc/share/misc/dev.archlist.txt#6 integrate
.. //depot/projects/dtrace/src/rescue/librescue/Makefile#3 integrate
.. //depot/projects/dtrace/src/sbin/Makefile#5 integrate
.. //depot/projects/dtrace/src/sbin/ifconfig/ifconfig.8#3 integrate
.. //depot/projects/dtrace/src/sbin/ifconfig/ifieee80211.c#3 integrate
.. //depot/projects/dtrace/src/sbin/ipfw/ipfw.8#5 integrate
.. //depot/projects/dtrace/src/sbin/ping6/Makefile#3 integrate
.. //depot/projects/dtrace/src/sbin/route/Makefile#3 integrate
.. //depot/projects/dtrace/src/sbin/rtsol/Makefile#3 integrate
.. //depot/projects/dtrace/src/sbin/setkey/Makefile#3 integrate
.. //depot/projects/dtrace/src/sbin/sysctl/sysctl.c#3 integrate
.. //depot/projects/dtrace/src/share/man/man4/Makefile#11 integrate
.. //depot/projects/dtrace/src/share/man/man4/acpi_thermal.4#3 integrate
.. //depot/projects/dtrace/src/share/man/man4/altq.4#6 integrate
.. //depot/projects/dtrace/src/share/man/man4/enc.4#2 integrate
.. //depot/projects/dtrace/src/share/man/man4/miibus.4#4 integrate
.. //depot/projects/dtrace/src/share/man/man4/polling.4#4 integrate
.. //depot/projects/dtrace/src/share/man/man4/stge.4#1 branch
.. //depot/projects/dtrace/src/share/man/man4/vlan.4#3 integrate
.. //depot/projects/dtrace/src/share/man/man5/rc.conf.5#9 integrate
.. //depot/projects/dtrace/src/share/man/man8/rc.subr.8#4 integrate
.. //depot/projects/dtrace/src/share/man/man9/mbuf.9#3 integrate
.. //depot/projects/dtrace/src/share/misc/bsd-family-tree#5 integrate
.. //depot/projects/dtrace/src/sys/amd64/amd64/machdep.c#5 integrate
.. //depot/projects/dtrace/src/sys/amd64/amd64/trap.c#4 integrate
.. //depot/projects/dtrace/src/sys/amd64/amd64/vm_machdep.c#3 integrate
.. //depot/projects/dtrace/src/sys/amd64/ia32/ia32_syscall.c#3 integrate
.. //depot/projects/dtrace/src/sys/arm/arm/trap.c#4 integrate
.. //depot/projects/dtrace/src/sys/arm/at91/kb920x_machdep.c#7 integrate
.. //depot/projects/dtrace/src/sys/arm/include/db_machdep.h#3 integrate
.. //depot/projects/dtrace/src/sys/arm/xscale/i80321/i80321.c#3 integrate
.. //depot/projects/dtrace/src/sys/arm/xscale/i80321/iq80321.c#5 integrate
.. //depot/projects/dtrace/src/sys/boot/forth/loader.conf#4 integrate
.. //depot/projects/dtrace/src/sys/compat/svr4/svr4_stream.c#5 integrate
.. //depot/projects/dtrace/src/sys/conf/Makefile.arm#5 integrate
.. //depot/projects/dtrace/src/sys/conf/NOTES#13 integrate
.. //depot/projects/dtrace/src/sys/conf/files#23 integrate
.. //depot/projects/dtrace/src/sys/conf/files.i386#10 integrate
.. //depot/projects/dtrace/src/sys/conf/files.powerpc#4 integrate
.. //depot/projects/dtrace/src/sys/crypto/via/padlock.c#7 integrate
.. //depot/projects/dtrace/src/sys/crypto/via/padlock.h#1 branch
.. //depot/projects/dtrace/src/sys/crypto/via/padlock_cipher.c#1 branch
.. //depot/projects/dtrace/src/sys/crypto/via/padlock_hash.c#1 branch
.. //depot/projects/dtrace/src/sys/dev/acpica/acpi_thermal.c#3 integrate
.. //depot/projects/dtrace/src/sys/dev/ata/ata-chipset.c#5 integrate
.. //depot/projects/dtrace/src/sys/dev/ata/ata-pci.h#4 integrate
.. //depot/projects/dtrace/src/sys/dev/ath/ath_rate/sample/sample.h#3 integrate
.. //depot/projects/dtrace/src/sys/dev/ath/if_ath.c#8 integrate
.. //depot/projects/dtrace/src/sys/dev/em/if_em.c#6 integrate
.. //depot/projects/dtrace/src/sys/dev/iwi/if_iwi.c#6 integrate
.. //depot/projects/dtrace/src/sys/dev/kbdmux/kbdmux.c#3 integrate
.. //depot/projects/dtrace/src/sys/dev/mii/gentbi.c#1 branch
.. //depot/projects/dtrace/src/sys/dev/mii/ip1000phy.c#1 branch
.. //depot/projects/dtrace/src/sys/dev/mii/ip1000phyreg.h#1 branch
.. //depot/projects/dtrace/src/sys/dev/mii/miidevs#4 integrate
.. //depot/projects/dtrace/src/sys/dev/mpt/mpt_cam.c#13 integrate
.. //depot/projects/dtrace/src/sys/dev/mpt/mpt_pci.c#11 integrate
.. //depot/projects/dtrace/src/sys/dev/ral/rt2560.c#4 integrate
.. //depot/projects/dtrace/src/sys/dev/scc/scc_core.c#2 integrate
.. //depot/projects/dtrace/src/sys/dev/scc/scc_dev_z8530.c#2 integrate
.. //depot/projects/dtrace/src/sys/dev/sk/if_sk.c#7 integrate
.. //depot/projects/dtrace/src/sys/dev/sk/if_skreg.h#6 integrate
.. //depot/projects/dtrace/src/sys/dev/stge/if_stge.c#1 branch
.. //depot/projects/dtrace/src/sys/dev/stge/if_stgereg.h#1 branch
.. //depot/projects/dtrace/src/sys/dev/uart/uart_cpu_powerpc.c#2 integrate
.. //depot/projects/dtrace/src/sys/dev/uart/uart_dev_z8530.c#4 integrate
.. //depot/projects/dtrace/src/sys/dev/uart/uart_tty.c#3 integrate
.. //depot/projects/dtrace/src/sys/dev/usb/if_ural.c#6 integrate
.. //depot/projects/dtrace/src/sys/dev/usb/uplcom.c#3 integrate
.. //depot/projects/dtrace/src/sys/dev/usb/usbdevs#5 integrate
.. //depot/projects/dtrace/src/sys/fs/udf/ecma167-udf.h#3 integrate
.. //depot/projects/dtrace/src/sys/fs/udf/udf_vfsops.c#4 integrate
.. //depot/projects/dtrace/src/sys/geom/eli/g_eli.c#5 integrate
.. //depot/projects/dtrace/src/sys/geom/eli/g_eli_integrity.c#2 integrate
.. //depot/projects/dtrace/src/sys/i386/conf/GENERIC#13 integrate
.. //depot/projects/dtrace/src/sys/i386/i386/machdep.c#6 integrate
.. //depot/projects/dtrace/src/sys/i386/i386/trap.c#9 integrate
.. //depot/projects/dtrace/src/sys/ia64/ia32/ia32_trap.c#3 integrate
.. //depot/projects/dtrace/src/sys/ia64/ia64/trap.c#5 integrate
.. //depot/projects/dtrace/src/sys/kern/kern_malloc.c#3 integrate
.. //depot/projects/dtrace/src/sys/kern/kern_mutex.c#7 integrate
.. //depot/projects/dtrace/src/sys/kern/kern_rwlock.c#4 integrate
.. //depot/projects/dtrace/src/sys/kern/kern_sx.c#3 integrate
.. //depot/projects/dtrace/src/sys/kern/subr_acl_posix1e.c#2 integrate
.. //depot/projects/dtrace/src/sys/kern/sys_socket.c#3 integrate
.. //depot/projects/dtrace/src/sys/kern/uipc_domain.c#5 integrate
.. //depot/projects/dtrace/src/sys/kern/uipc_sockbuf.c#1 branch
.. //depot/projects/dtrace/src/sys/kern/uipc_socket.c#7 integrate
.. //depot/projects/dtrace/src/sys/kern/uipc_socket2.c#6 integrate
.. //depot/projects/dtrace/src/sys/kern/uipc_syscalls.c#7 integrate
.. //depot/projects/dtrace/src/sys/kern/uipc_usrreq.c#8 integrate
.. //depot/projects/dtrace/src/sys/kern/vfs_syscalls.c#6 integrate
.. //depot/projects/dtrace/src/sys/modules/Makefile#13 integrate
.. //depot/projects/dtrace/src/sys/modules/agp/Makefile#3 integrate
.. //depot/projects/dtrace/src/sys/modules/asr/Makefile#3 integrate
.. //depot/projects/dtrace/src/sys/modules/bridgestp/Makefile#1 branch
.. //depot/projects/dtrace/src/sys/modules/hwpmc/Makefile#3 integrate
.. //depot/projects/dtrace/src/sys/modules/if_bridge/Makefile#3 integrate
.. //depot/projects/dtrace/src/sys/modules/mii/Makefile#3 integrate
.. //depot/projects/dtrace/src/sys/modules/osf1/Makefile#3 delete
.. //depot/projects/dtrace/src/sys/modules/padlock/Makefile#3 integrate
.. //depot/projects/dtrace/src/sys/modules/stge/Makefile#1 branch
.. //depot/projects/dtrace/src/sys/net/bpf.c#7 integrate
.. //depot/projects/dtrace/src/sys/net/bridgestp.c#3 integrate
.. //depot/projects/dtrace/src/sys/net/bridgestp.h#1 branch
.. //depot/projects/dtrace/src/sys/net/if_bridge.c#8 integrate
.. //depot/projects/dtrace/src/sys/net/if_bridgevar.h#3 integrate
.. //depot/projects/dtrace/src/sys/net/if_enc.c#4 integrate
.. //depot/projects/dtrace/src/sys/net/if_ethersubr.c#3 integrate
.. //depot/projects/dtrace/src/sys/net/if_gif.c#5 integrate
.. //depot/projects/dtrace/src/sys/net80211/ieee80211.c#4 integrate
.. //depot/projects/dtrace/src/sys/net80211/ieee80211.h#3 integrate
.. //depot/projects/dtrace/src/sys/net80211/ieee80211_freebsd.h#3 integrate
.. //depot/projects/dtrace/src/sys/net80211/ieee80211_ioctl.c#4 integrate
.. //depot/projects/dtrace/src/sys/net80211/ieee80211_ioctl.h#3 integrate
.. //depot/projects/dtrace/src/sys/net80211/ieee80211_output.c#3 integrate
.. //depot/projects/dtrace/src/sys/net80211/ieee80211_proto.c#3 integrate
.. //depot/projects/dtrace/src/sys/net80211/ieee80211_proto.h#3 integrate
.. //depot/projects/dtrace/src/sys/net80211/ieee80211_var.h#3 integrate
.. //depot/projects/dtrace/src/sys/netgraph/bluetooth/socket/ng_btsocket_rfcomm.c#4 integrate
.. //depot/projects/dtrace/src/sys/netgraph/ng_ether.c#3 integrate
.. //depot/projects/dtrace/src/sys/netgraph/ng_ksocket.c#3 integrate
.. //depot/projects/dtrace/src/sys/netinet6/README#3 delete
.. //depot/projects/dtrace/src/sys/netinet6/icmp6.c#3 integrate
.. //depot/projects/dtrace/src/sys/netipsec/keysock.c#4 integrate
.. //depot/projects/dtrace/src/sys/netncp/ncp_sock.c#3 integrate
.. //depot/projects/dtrace/src/sys/netsmb/smb_trantcp.c#3 integrate
.. //depot/projects/dtrace/src/sys/nfsclient/nfs_socket.c#6 integrate
.. //depot/projects/dtrace/src/sys/nfsserver/nfs_srvsock.c#3 integrate
.. //depot/projects/dtrace/src/sys/powerpc/conf/GENERIC#3 integrate
.. //depot/projects/dtrace/src/sys/powerpc/conf/NOTES#3 integrate
.. //depot/projects/dtrace/src/sys/powerpc/include/md_var.h#3 integrate
.. //depot/projects/dtrace/src/sys/powerpc/include/ofw_machdep.h#3 integrate
.. //depot/projects/dtrace/src/sys/powerpc/include/pcb.h#3 integrate
.. //depot/projects/dtrace/src/sys/powerpc/powerpc/clock.c#5 integrate
.. //depot/projects/dtrace/src/sys/powerpc/powerpc/mem.c#3 integrate
.. //depot/projects/dtrace/src/sys/powerpc/powerpc/ofw_machdep.c#3 integrate
.. //depot/projects/dtrace/src/sys/powerpc/powerpc/trap.c#3 integrate
.. //depot/projects/dtrace/src/sys/powerpc/psim/sio_iobus.c#3 delete
.. //depot/projects/dtrace/src/sys/powerpc/psim/uart_iobus.c#1 branch
.. //depot/projects/dtrace/src/sys/sparc64/conf/GENERIC#7 integrate
.. //depot/projects/dtrace/src/sys/sparc64/sparc64/trap.c#4 integrate
.. //depot/projects/dtrace/src/sys/sys/_label.h#3 integrate
.. //depot/projects/dtrace/src/sys/sys/bufobj.h#4 integrate
.. //depot/projects/dtrace/src/sys/sys/extattr.h#3 integrate
.. //depot/projects/dtrace/src/sys/sys/mbuf.h#4 integrate
.. //depot/projects/dtrace/src/sys/sys/mutex.h#4 integrate
.. //depot/projects/dtrace/src/sys/sys/protosw.h#6 integrate
.. //depot/projects/dtrace/src/sys/sys/socket.h#3 integrate
.. //depot/projects/dtrace/src/sys/sys/socketvar.h#3 integrate
.. //depot/projects/dtrace/src/sys/sys/syscallsubr.h#5 integrate
.. //depot/projects/dtrace/src/sys/sys/unpcb.h#3 integrate
.. //depot/projects/dtrace/src/sys/vm/vm_object.c#4 integrate
.. //depot/projects/dtrace/src/tools/tools/nanobsd/FlashDevice.sub#4 integrate
.. //depot/projects/dtrace/src/usr.bin/enigma/enigma.c#3 integrate
.. //depot/projects/dtrace/src/usr.bin/ftp/Makefile#3 integrate
.. //depot/projects/dtrace/src/usr.bin/logger/Makefile#3 integrate
.. //depot/projects/dtrace/src/usr.bin/make/parse.c#3 integrate
.. //depot/projects/dtrace/src/usr.bin/rpcinfo/Makefile#3 integrate
.. //depot/projects/dtrace/src/usr.bin/systat/Makefile#3 integrate
.. //depot/projects/dtrace/src/usr.bin/systat/mbufs.c#4 integrate
.. //depot/projects/dtrace/src/usr.bin/telnet/Makefile#3 integrate
.. //depot/projects/dtrace/src/usr.bin/truss/i386-fbsd.c#4 integrate
.. //depot/projects/dtrace/src/usr.sbin/Makefile#6 integrate
.. //depot/projects/dtrace/src/usr.sbin/inetd/Makefile#4 integrate
.. //depot/projects/dtrace/src/usr.sbin/lpr/Makefile.inc#3 integrate
.. //depot/projects/dtrace/src/usr.sbin/mld6query/Makefile#3 integrate
.. //depot/projects/dtrace/src/usr.sbin/ndp/Makefile#3 integrate
.. //depot/projects/dtrace/src/usr.sbin/rip6query/Makefile#3 integrate
.. //depot/projects/dtrace/src/usr.sbin/route6d/Makefile#3 integrate
.. //depot/projects/dtrace/src/usr.sbin/rrenumd/Makefile#3 integrate
.. //depot/projects/dtrace/src/usr.sbin/rtadvd/Makefile#3 integrate
.. //depot/projects/dtrace/src/usr.sbin/rtsold/Makefile#3 integrate
.. //depot/projects/dtrace/src/usr.sbin/sysinstall/devices.c#3 integrate
.. //depot/projects/dtrace/src/usr.sbin/syslogd/Makefile#3 integrate
.. //depot/projects/dtrace/src/usr.sbin/traceroute6/Makefile#3 integrate
.. //depot/projects/dtrace/src/usr.sbin/trpt/Makefile#3 integrate
.. //depot/projects/dtrace/src/usr.sbin/trpt/trpt.c#3 integrate
.. //depot/projects/dtrace/www/de/docs/books.sgml#4 integrate
.. //depot/projects/dtrace/www/de/news/news.xml#10 integrate
.. //depot/projects/dtrace/www/de/news/press.xml#8 integrate
.. //depot/projects/dtrace/www/de/platforms/alpha.sgml#2 integrate
.. //depot/projects/dtrace/www/en/cgi/Makefile#2 integrate
.. //depot/projects/dtrace/www/en/cgi/cgi-style.pl#3 integrate
.. //depot/projects/dtrace/www/en/cgi/gallery.cgi#2 delete
.. //depot/projects/dtrace/www/en/docs/books.sgml#3 integrate
.. //depot/projects/dtrace/www/en/gnome/news.xml#5 integrate
.. //depot/projects/dtrace/www/en/projects/ideas/index.sgml#11 integrate
.. //depot/projects/dtrace/www/en/prstats/Makefile#2 integrate
.. //depot/projects/dtrace/www/en/prstats/index.sgml#2 integrate
.. //depot/projects/dtrace/www/en/smp/index.sgml#3 integrate
.. //depot/projects/dtrace/www/en/snapshots/index.sgml#6 integrate
.. //depot/projects/dtrace/www/fr/prstats/Makefile#2 integrate
.. //depot/projects/dtrace/www/fr/prstats/index.sgml#2 integrate
.. //depot/projects/dtrace/www/ja/prstats/Makefile#2 integrate
.. //depot/projects/dtrace/www/share/sgml/includes.header.xsl#3 integrate
.. //depot/projects/dtrace/www/share/sgml/usergroups.xml#6 integrate
Differences ...
==== //depot/projects/dtrace/doc/en_US.ISO8859-1/articles/contributors/contrib.additional.sgml#17 (text+ko) ====
@@ -1,4 +1,4 @@
-<!-- $FreeBSD: doc/en_US.ISO8859-1/articles/contributors/contrib.additional.sgml,v 1.593 2006/07/18 22:27:23 acm Exp $ -->
+<!-- $FreeBSD: doc/en_US.ISO8859-1/articles/contributors/contrib.additional.sgml,v 1.594 2006/07/26 19:45:59 novel Exp $ -->
<!--
NOTE TO COMMITTERS: Contributors lists are sorted in alphabetical
order by first name.
@@ -5592,6 +5592,11 @@
</listitem>
<listitem>
+ <para>Martin Tournoij
+ <email>carpetsmoker at gmail.com</email></para>
+ </listitem>
+
+ <listitem>
<para>Martti Kuparinen
<email>martti.kuparinen at ericsson.com</email></para>
</listitem>
==== //depot/projects/dtrace/doc/en_US.ISO8859-1/books/porters-handbook/book.sgml#15 (text+ko) ====
@@ -1,7 +1,7 @@
<!--
The FreeBSD Documentation Project
- $FreeBSD: doc/en_US.ISO8859-1/books/porters-handbook/book.sgml,v 1.735 2006/07/20 11:20:58 erwin Exp $
+ $FreeBSD: doc/en_US.ISO8859-1/books/porters-handbook/book.sgml,v 1.737 2006/07/24 20:32:20 simon Exp $
-->
<!DOCTYPE BOOK PUBLIC "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN" [
@@ -9553,194 +9553,30 @@
<sect1 id="dads-uid-and-gids">
<title>UIDs and GIDs</title>
+ <para>The current list of reserved UIDs and GIDs can be found
+ in <filename>ports/UIDs</filename> and
+ <filename>ports/GIDs</filename>.</para>
+
<para>If your port requires a certain user to be on the installed
system, let the <filename>pkg-install</filename> script call
<command>pw</command> to create it automatically. Look at
- <filename role="package">net/cvsup-mirror</filename> for an example.</para>
+ <filename role="package">net/cvsup-mirror</filename> for an example.
+ Please note that this is strongly discouraged, please register
+ user/group ID numbers as stated below.</para>
<para>If your port must use the same user/group ID number when it is
installed as a binary package as when it was compiled, then you must
- choose a free UID from 50 to 999 and register it below. Look at
+ choose a free UID from 50 to 999 and register it either in
+ <filename>ports/UIDs</filename> (for users) or in
+ <filename>ports/GIDs</filename> (for groups). Look at
<filename role="package">japanese/Wnn6</filename> for an example.</para>
<para>Make sure you do not use a UID already used by the system or
other ports.</para>
- <para>This is the current list of UIDs between 50 and 999.</para>
-
- <!-- Please keep this list sorted by uid -->
- <programlisting>bind:*:53:53:Bind Sandbox:/:/sbin/nologin
-majordom:*:54:54:Majordomo Pseudo User:/usr/local/majordomo:/nonexistent
-rdfdb:*:55:55:rdfDB Daemon:/var/db/rdfdb:/bin/sh
-spamd:*:58:58:SpamAssassin user:/var/spool/spamd:/sbin/nologin
-cyrus:*:60:60:the cyrus mail server:/nonexistent:/nonexistent
-gnats:*:61:1:GNATS database owner:/usr/local/share/gnats/gnats-db:/bin/sh
-proxy:*:62:62:Packet Filter pseudo-user:/nonexistent:/nonexistent
-uucp:*:66:66:UUCP pseudo-user:/var/spool/uucppublic:/usr/libexec/uucp/uucico
-xten:*:67:67:X-10 daemon:/usr/local/xten:/nonexistent
-pop:*:68:6:Post Office Owner (popper):/nonexistent:/sbin/nologin
-wnn:*:69:7:Wnn:/nonexistent:/nonexistent
-pgsql:*:70:70:PostgreSQL pseudo-user:/usr/local/pgsql:/bin/sh
-oracle:*:71:71::0:0:Oracle:/usr/local/oracle7:/sbin/nologin
-ircd:*:72:72:IRC daemon:/nonexistent:/nonexistent
-ircservices:*:73:73:IRC services:/nonexistent:/nonexistent
-simscan:*:74:74:Simscan User:/nonexistent:/sbin/nologin
-ifmail:*:75:66:Ifmail user:/nonexistent:/nonexistent
-www:*:80:80:World Wide Web Owner:/nonexistent:/sbin/nologin
-alias:*:81:81:QMail user:/var/qmail/alias:/nonexistent
-qmaild:*:82:81:QMail user:/var/qmail:/nonexistent
-qmaill:*:83:81:QMail user:/var/qmail:/nonexistent
-qmailp:*:84:81:QMail user:/var/qmail:/nonexistent
-qmailq:*:85:82:QMail user:/var/qmail:/nonexistent
-qmailr:*:86:82:QMail user:/var/qmail:/nonexistent
-qmails:*:87:82:QMail user:/var/qmail:/nonexistent
-mysql:*:88:88:MySQL Daemon:/var/db/mysql:/sbin/nologin
-vpopmail:*:89:89:VPop Mail User:/usr/local/vpopmail:/nonexistent
-firebird:*:90:90:Firebird Database Administrator:/usr/local/firebird:/bin/sh
-mailman:*:91:91:Mailman User:/usr/local/mailman:/sbin/nologin
-gdm:*:92:92:GDM Sandbox:/:/sbin/nologin
-jabber:*:93:93:Jabber Daemon:/nonexistent:/nonexistent
-p4admin:*:94:94:Perforce admin:/usr/local/perforce:/sbin/nologin
-interch:*:95:95:Interchange user:/usr/local/interchange:/sbin/nologin
-squeuer:*:96:96:SQueuer Owner:/nonexistent:/bin/sh
-mud:*:97:97:MUD Owner:/nonexistent:/bin/sh
-msql:*:98:98:mSQL-2 pseudo-user:/var/db/msqldb:/bin/sh
-rscsi:*:99:99:Remote SCSI:/usr/local/rscsi:/usr/local/sbin/rscsi
-squid:*:100:100:squid caching-proxy pseudo user:/usr/local/squid:/sbin/nologin
-quagga:*:101:101:Quagga route daemon pseudo user:/usr/local/etc/quagga:/sbin/nologin
-ganglia:*:102:102:Ganglia User:/nonexistent:/sbin/nologin
-sgeadmin:*:103:103:Sun Grid Engine Admin:/nonexistent:/sbin/nologin
-slimserv:*:104:104:Slim Devices SlimServer pseudo-user:/nonexistent:/sbin/nologin
-dnetc:*:105:105:distributed.net client and proxy pseudo-user:/nonexistent:/sbin/nologin
-clamav:*:106:106:Clamav Antivirus:/nonexistent:/sbin/nologin
-cacti:*:107:107:Cacti Sandbox:/nonexistent:/sbin/nologin
-webkit:*:108:108:WebKit Default User:/usr/local/www/webkit:/bin/sh
-quickml:*:109:109:quickml Server:/nonexistent:/sbin/nologin
-vscan:*:110:110:Scanning Virus Account:/var/amavis:/bin/sh
-fido:*:111:111:Fido System:/usr/local/fido:/bin/sh
-dcc:*:112:112:Distributed Checksum Clearinghouse:/nonexistent:/sbin/nologin
-amavis:*:113:113:Amavis-stats Account:/nonexistent:/sbin/nologin
-dhis:*:114:114:DHIS Daemon:/nonexistent:/sbin/nologin
-_symon:*:115:115:Symon Account:/var/empty:/sbin/nologin
-hplip:*:116:116:HPLIP Server:/nonexistent:/sbin/nologin
-postfix:*:125:125:Postfix Mail System:/var/spool/postfix:/sbin/nologin
-_bgpd:*:130:130:BGP Daemon:/var/empty:/sbin/nologin
-_ospfd:*:131:131:OSPF Daemon:/var/empty:/sbin/nologin
-rbldns:*:153:153:rbldnsd pseudo-user:/nonexistent:/sbin/nologin
-sfs:*:171:171:Self-Certifying File System:/nonexistent:/sbin/nologin
-agk:*:172:172:AquaGateKeeper:/nonexistent:/nonexistent
-polipo:*:173:173:polipo web cache:/nonexistent:/sbin/nologin
-bogomilter:*:174:174:milter-bogom:/nonexistent:/sbin/nologin
-moinmoin:*:192:192:MoinMoin User:/nonexistent:/sbin/nologin
-sympa:*:200:200:Sympa Owner:/nonexistent:/sbin/nologin
-privoxy:*:201:201:Privoxy proxy user:/nonexistent:/sbin/nologin
-dspam:*:202:202:Dspam:/nonexistent:/sbin/nologin
-shoutcast:*:210:210:Shoutcast sandbox:/nonexistent:/bin/sh
-_tor:*:256:256:Tor anonymising router:/var/db/tor:/bin/sh
-smxs:*:260:260:Sendmail X SMTPS:/nonexistent:/sbin/nologin
-smxq:*:261:261:Sendmail X QMGR:/nonexistent:/sbin/nologin
-smxc:*:262:262:Sendmail X SMTPC:/nonexistent:/sbin/nologin
-smxm:*:263:263:Sendmail X misc:/nonexistent:/sbin/nologin
-smx:*:264:264:Sendmail X other:/nonexistent:/sbin/nologin
-mrtg:*:279:279:MRTG daemon:/nonexistent:/sbin/nologin
-ldap:*:389:389:OpenLDAP Server:/nonexistent:/sbin/nologin
-drweb:*:426:426:Dr.Web Mail Scanner:/nonexistent:/sbin/nologin
-courier:*:465:465:Courier Mail Server:/nonexistent:/sbin/nologin
-_bbstored:*:505:505::0:0:BoxBackup Store Daemon:/nonexistent:/bin/sh
-ejabberd:*:544:544::0:0:ejabberd pseudo user:/var/spool/ejabberd:/bin/sh
-qtss:*:554:554:Darwin Streaming Server:/nonexistent:/sbin/nologin
-ircdru:*:555:555:Russian hybrid IRC server:/nonexistent:/bin/sh
-messagebus:*:556:556:D-BUS Daemon User:/nonexistent:/sbin/nologin
-avahi:*:558:558:Avahi Daemon User:/nonexistent:/sbin/nologin
-bnetd:*:700:700:Bnetd user:/nonexistent:/sbin/nologin
-bopm:*:717:717:Blitzed Open Proxy Monitor:/nonexistent:/bin/sh
-openxpki:*:777:777:OpenXPKI Owner:/nonexistent:/usr/sbin/nologin
-bacula:*:910:910:Bacula Daemon:/var/db/bacula:/sbin/nologin</programlisting>
-
- <para>This is the current list of reserved GIDs.</para>
-
- <!-- Please keep this list sorted by gid -->
- <!-- XXX incomplete! -->
- <programlisting>bind:*:53:
-rdfdb:*:55:
-spamd:*:58:
-cyrus:*:60:
-proxy:*:62:
-authpf:*:63:
-uucp:*:66:
-xten:*:67:
-dialer:*:68:
-network:*:69:
-pgsql:*:70:
-simscan:*:74:
-audit:*:77:
-www:*:80:
-qnofiles:*:81:
-qmail:*:82:
-mysql:*:88:
-vpopmail:*:89:
-firebird:*:90:
-mailman:*:91:
-gdm:*:92:
-jabber:*:93:
-p4admin:*:94:
-interch:*:95:
-squeuer:*:96:
-mud:*:97:
-msql:*:98:
-rscsi:*:99:
-squid:*:100:
-quagga:*:101:
-ganglia:*:102:
-sgeadmin:*:103:
-slimserv:*:104:
-dnetc:*:105:
-clamav:*:106:
-cacti:*:107:
-webkit:*:108:
-quickml:*:109:
-vscan:*:110:
-fido:*:111:
-dcc:*:112:
-amavis:*:113:
-dhis:*:114:
-_symon:*:115:
-postfix:*:125:
-maildrop:*:126:
-_bgpd:*:130:
-_ospfd:*:131:
-rbldns:*:153:
-sfs:*:171:
-agk:*:172:
-polipo:*:173:
-moinmoin:*:192:
-sympa:*:200:
-dspam:*:202:
-_tor:*:256:
-smxs:*:260:
-smxq:*:261:
-smxc:*:262:
-smxm:*:263:
-smx:*:264:
-mrtg:*:279:
-ldap:*:389:
-drweb:*:426:
-courier:*:465:
-_bbstored:*:505:
-ejabberd:*:544:
-qtss:*:554:
-ircdru:*:555:
-messagebus:*:556:
-realtime:*:557:
-avahi:*:558:
-bnetd:*:700:
-bopm:*:717:
-openxpki:*:777:
-bacula:*:910:</programlisting>
-
- <para>Please include a notice when you submit a port (or an upgrade)
- that reserves a new UID or GID in this range. This allows us to
- keep the list of reserved IDs up to date.</para>
+ <para>Please include a patch against these two files when you
+ require a new user or group to be created for your
+ port.</para>
</sect1>
<sect1 id="dads-rational">
==== //depot/projects/dtrace/doc/share/sgml/man-refs.ent#10 (text+ko) ====
@@ -20,7 +20,7 @@
lexicographical order by the entity (i.e., the dots used in place of
special characters should not be expanded when comparing).
- $FreeBSD: doc/share/sgml/man-refs.ent,v 1.390 2006/06/25 15:07:09 marck Exp $
+ $FreeBSD: doc/share/sgml/man-refs.ent,v 1.393 2006/07/25 15:38:35 bmah Exp $
-->
<!ENTITY man...1 "<citerefentry/<refentrytitle/[/<manvolnum/1//">
@@ -3304,6 +3304,7 @@
<!ENTITY man.em.4 "<citerefentry/<refentrytitle/em/<manvolnum/4//">
<!ENTITY man.emu10k1.4 "<citerefentry/<refentrytitle/emu10k1/<manvolnum/4//">
<!ENTITY man.en.4 "<citerefentry/<refentrytitle/en/<manvolnum/4//">
+<!ENTITY man.enc.4 "<citerefentry/<refentrytitle/enc/<manvolnum/4//">
<!ENTITY man.ep.4 "<citerefentry/<refentrytitle/ep/<manvolnum/4//">
<!ENTITY man.esp.4 "<citerefentry/<refentrytitle/esp/<manvolnum/4//">
<!ENTITY man.ex.4 "<citerefentry/<refentrytitle/ex/<manvolnum/4//">
@@ -3505,6 +3506,7 @@
<!ENTITY man.npx.4 "<citerefentry/<refentrytitle/npx/<manvolnum/4//">
<!ENTITY man.nsp.4 "<citerefentry/<refentrytitle/nsp/<manvolnum/4//">
<!ENTITY man.null.4 "<citerefentry/<refentrytitle/null/<manvolnum/4//">
+<!ENTITY man.nfe.4 "<citerefentry/<refentrytitle/nfe/<manvolnum/4//">
<!ENTITY man.nve.4 "<citerefentry/<refentrytitle/nve/<manvolnum/4//">
<!ENTITY man.ofw.console.4 "<citerefentry/<refentrytitle/ofw_console/<manvolnum/4//">
<!ENTITY man.ohci.4 "<citerefentry/<refentrytitle/ohci/<manvolnum/4//">
@@ -3601,6 +3603,7 @@
<!ENTITY man.snd.csa.4 "<citerefentry/<refentrytitle/snd_csa/<manvolnum/4//">
<!ENTITY man.snd.ds1.4 "<citerefentry/<refentrytitle/snd_ds1/<manvolnum/4//">
<!ENTITY man.snd.emu10k1.4 "<citerefentry/<refentrytitle/snd_emu10k1/<manvolnum/4//">
+<!ENTITY man.snd.emu10kx.4 "<citerefentry/<refentrytitle/snd_emu10kx/<manvolnum/4//">
<!ENTITY man.snd.envy24.4 "<citerefentry/<refentrytitle/snd_envy24/<manvolnum/4//">
<!ENTITY man.snd.es137x.4 "<citerefentry/<refentrytitle/snd_es137x/<manvolnum/4//">
<!ENTITY man.snd.ess.4 "<citerefentry/<refentrytitle/snd_ess/<manvolnum/4//">
@@ -3633,6 +3636,7 @@
<!ENTITY man.ste.4 "<citerefentry/<refentrytitle/ste/<manvolnum/4//">
<!ENTITY man.stf.4 "<citerefentry/<refentrytitle/stf/<manvolnum/4//">
<!ENTITY man.stg.4 "<citerefentry/<refentrytitle/stg/<manvolnum/4//">
+<!ENTITY man.stge.4 "<citerefentry/<refentrytitle/stge/<manvolnum/4//">
<!ENTITY man.stl.4 "<citerefentry/<refentrytitle/stl/<manvolnum/4//">
<!ENTITY man.stli.4 "<citerefentry/<refentrytitle/stli/<manvolnum/4//">
<!ENTITY man.streams.4 "<citerefentry/<refentrytitle/streams/<manvolnum/4//">
@@ -3891,6 +3895,7 @@
<!ENTITY man.uuencode.5 "<citerefentry/<refentrytitle/uuencode/<manvolnum/5//">
<!ENTITY man.uuencode.format.5 "<citerefentry/<refentrytitle/uuencode.format/<manvolnum/5//">
<!ENTITY man.vgrindefs.5 "<citerefentry/<refentrytitle/vgrindefs/<manvolnum/5//">
+<!ENTITY man.wpa.supplicant.conf.5 "<citerefentry/<refentrytitle/wpa_supplicant.conf/<manvolnum/5//">
<!ENTITY man.wtmp.5 "<citerefentry/<refentrytitle/wtmp/<manvolnum/5//">
<!ENTITY man.adventure.6 "<citerefentry/<refentrytitle/adventure/<manvolnum/6//">
==== //depot/projects/dtrace/doc/zh_TW.Big5/books/developers-handbook/book.sgml#2 (text+ko) ====
@@ -1,7 +1,8 @@
<!--
The FreeBSD Documentation Project
- $FreeBSD: doc/zh_TW.Big5/books/developers-handbook/book.sgml,v 1.1 2006/06/17 10:22:43 vanilla Exp $
+ $FreeBSD: doc/zh_TW.Big5/books/developers-handbook/book.sgml,v 1.2 2006/07/26 03:57:20 vanilla Exp $
+ Original revision: 1.52
-->
<!DOCTYPE BOOK PUBLIC "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN" [
@@ -15,7 +16,7 @@
<bookinfo>
<title>FreeBSD Developers' Handbook</title>
- <corpauthor>The FreeBSD Documentation Project</corpauthor>
+ <corpauthor>FreeBSD ¤å¥ópµe</corpauthor>
<pubdate>August 2000</pubdate>
@@ -46,25 +47,25 @@
</legalnotice>
<abstract>
- <para>Welcome to the Developers' Handbook. This manual is a
- <emphasis>work in progress</emphasis> and is the work of many
- individuals. Many sections do not yet exist and some of those
- that do exist need to be updated. If you are interested in
- helping with this project, send email to the &a.doc;.</para>
-
- <para>The latest version of this document is always available
- from the <ulink url="&url.base;/index.html">FreeBSD World
- Wide Web server</ulink>. It may also be downloaded in a
- variety of formats and compression options from the <ulink
- url="ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/">FreeBSD FTP
- server</ulink> or one of the numerous <ulink
- url="&url.books.handbook;/mirrors-ftp.html">mirror
- sites</ulink>.</para>
+ <para>
+ Åwªï¨Ï¥Î Developers' Handbook¡I
+ ³o¥÷¤å¥ó¬O¥Ñ³\¦h¤H <emphasis>¤£Â_¼¶¼g</emphasis> ¦Ó¦¨ªº¡A
+ ¦Ó¥B³\¦h³¹¸`¤´»Ý§ó·s©ÎªÌ¤º®eÁÙ¬O¤@¤ùªÅ¥Õ¡A
+ ¦pªG§A·QÀ°¦£ FreeBSD ¤å¥óp¹º¡A
+ ½Ð±H«H¨ì &a.doc;¡C
+ </para>
+
+ <para>
+ ³Ì·sª©ªº¤å¥ó³£¦b <ulink url="&url.base;/index.html">FreeBSD ©xºô</ulink> ¤W±¡A
+ ¤]¥i±q <ulink url="ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/">FreeBSD FTP server</ulink> ¤U¸ü¤£¦P®æ¦¡ªº¸ê®Æ¡C
+ ·íµM¤]¥i¥H¦b¨ä¥Lªº <ulink url="&url.books.handbook;/mirrors-ftp.html">mirror¯¸</ulink>¤U¸ü¡C
+ </para>
+
</abstract>
</bookinfo>
<part id="Basics">
- <title>Basics</title>
+ <title>°ò¥»·§©À</title>
&chap.introduction;
&chap.tools;
@@ -75,7 +76,7 @@
</part>
<part id="ipc">
- <title>Interprocess Communication</title>
+ <title>Interprocess Communication(IPC)</title>
&chap.sockets;
&chap.ipv6;
@@ -83,7 +84,7 @@
</part>
<part id="kernel">
- <title>Kernel</title>
+ <title>Kernel(®Ö¤ß)</title>
&chap.dma;
&chap.kerneldebug;
@@ -91,14 +92,14 @@
</part>
<part id="architectures">
- <title>Architectures</title>
+ <title>Architectures(¹q¸£¬[ºc)</title>
&chap.x86;
</part>
<part id="appendices">
- <title>Appendices</title>
+ <title>ªþ¿ý</title>
<bibliography>
==== //depot/projects/dtrace/doc/zh_TW.Big5/books/developers-handbook/introduction/chapter.sgml#2 (text+ko) ====
@@ -1,7 +1,8 @@
<!--
The FreeBSD Documentation Project
- $FreeBSD: doc/zh_TW.Big5/books/developers-handbook/introduction/chapter.sgml,v 1.1 2006/06/17 10:22:43 vanilla Exp $
+ $FreeBSD: doc/zh_TW.Big5/books/developers-handbook/introduction/chapter.sgml,v 1.2 2006/07/26 03:55:46 vanilla Exp $
+ Original revision: 1.18
-->
<chapter id="introduction">
@@ -18,83 +19,65 @@
</author>
</authorgroup>
</chapterinfo>
- <title>Introduction</title>
+ <title>²¤¶</title>
<sect1 id="introduction-devel">
- <title>Developing on FreeBSD</title>
+ <title>¦b FreeBSD ¶}µoµ{¦¡</title>
+ <para>¦n¤F§Ú̶}©l§a¡I§Ú·Q§Aªº FreeBSD ¤w¸g¦w¸Ë¦n¤F¡A¦Ó¥B¤w¸g·Ç³Æ¦nn¥Î¥¦¼gÂIµ{¦¡¤F§a¡H
+ ¦ý¬On±qþ¸Ì¶}©l©O¡H&os; ¦³´£¨Ñ¼gµ{¦¡ªºµ{¦¡©ÎÀô¹Ò¶Ü¡H
+ ¨¬° programer ªº§Ú¥i¥H°µ¤°»ò©O¡H</para>
- <para>So here we are. System all installed and you are ready to
- start programming. But where to start? What does FreeBSD
- provide? What can it do for me, as a programmer?</para>
-
- <para>These are some questions which this chapter tries to answer.
- Of course, programming has different levels of proficiency like
- any other trade. For some it is a hobby, for others it is their
- profession. The information in this chapter might be aimed
- toward the beginning programmer; indeed, it could serve useful
- for the programmer unfamiliar with the &os; platform.</para>
-
+ <para>¥»³¹¸ÕµÛ¦^µª§A¤@¨Ç°ÝÃD¡A·íµM¡A³æ´N programming µ{«×¨Ó»¡¥i¤À«Ü¦hºØ¼h¦¸¡A
+ ¦³ªº¤H¥u¬O³æ¯Â·í¿³½ì¡A¦³ªº«h¬O¥Lªº±M·~¡A
+ ¥»³¹¥Dn¤º®e¬O°w¹ïµ{¦¡ªì¾ÇªÌ¡A
+ ·íµM¡A¹ï©ó¨º¨Ç¤£¼ô &os; ªºµ{¦¡¶}µoªÌ¦Ó¨¥¡A¥»¤å¥ó¤º®e¤]¬O¤Q¤À¹ê¥Îªº¡C</para>
</sect1>
<sect1 id="introduction-bsdvision">
<title>The BSD Vision</title>
- <para>To produce the best &unix; like operating system package
- possible, with due respect to the original software tools
- ideology as well as usability, performance and
- stability.</para>
+ <para>¬°¤FÅý§A¼g¥X¨Óªºµ{¦¡¦b &unix; like¨t²Î¤W¨ã¦³¨}¦nªº¨Ï¥Î©Ê¡B®Ä¯à©Méw©Ê¡A
+ §ÚÌ¥²¶·¸ò§A¤¶²Ð¤@¨Çµ{¦¡·§©À(original software tools ideology)¡C </para>
</sect1>
<sect1 id="introduction-archguide">
- <title>Architectural Guidelines</title>
+ <title>µ{¦¡¬[ºc«ü«n</title>
- <para>Our ideology can be described by the following
- guidelines</para>
+ <para>§ÚÌ·Q¤¶²Ðªº·§©À¦p¤U</para>
<itemizedlist>
- <listitem><para>Do not add new functionality unless an
- implementor cannot complete a real application without
- it.</para></listitem>
+ <listitem><para>¦b¾ãÓµ{¦¡ÁÙ¨S¼g§¹«e¡A¤£n¼W¥[·sªº¥\¯à¡C</para></listitem>
- <listitem><para>It is as important to decide what a system is
- not as to decide what it is. Do not serve all the world's
- needs; rather, make the system extensible so that additional
- needs can be met in an upwardly compatible
- fashion.</para></listitem>
+ <listitem><para>¥t¥~¤@Ó«ÂI´N¬O¡AÅý§A¦Û¤v¿ï¾Ü§Aªºµ{¦¡±N·|¨ã¦³¦óºØ¥\¯à¡A
+ ¦Ó¤£¬OÅý§O¤H¨M©w¡A¤£·Qn¥hº¡¨¬¥þ¥@¬Éªº»Ý¨D¡A°£«D§A·QÅý§Aªºµ{¦¡¨ã¦³ÂX¥R©Ê©Î¬Û®e©Ê¡C</para></listitem>
- <listitem><para>The only thing worse than generalizing from one
- example is generalizing from no examples at
- all. </para></listitem>
+ <listitem><para>¤d¸U°O¦í¡G¦b¨S¦³¬ÛÃö¸gÅç®É¡A°Ñ¦Ò½d¨Òµ{¦¡½X©Ò¼g¥X¨Óªºµ{¦¡¡A
+ ·|¤ñ¦Û¤v¾ÌªÅ¼g¥X¨Óªº¦n¡C</para></listitem>
- <listitem><para>If a problem is not completely understood, it is
- probably best to provide no solution at all.</para></listitem>
+ <listitem><para>·í§A¼gªºµ{¦¡¨S¿ìªk§¹¥þ¸Ñ¨M°ÝÃD®É¡A³Ì¦nªº¤èªk´N¬O¤£n¸ÕµÛn¥h¸Ñ¨M¥¦¡C</para></listitem>
- <listitem><para>If you can get 90 percent of the desired effect
- for 10 percent of the work, use the simpler
- solution.</para></listitem>
+ <listitem><para>Y¥Î 10% ªº¤ß¤O´N¯à»´ÃP§¹¦¨ 90% ªº¤u§@¥÷¶q¡A´N¥Î³oÓ²³æªk¤l§a¡C</para></listitem>
- <listitem><para>Isolate complexity as much as
- possible.</para></listitem>
+ <listitem><para>ºÉ¥i¯à¦a²¤Æ°ÝÃDªº½ÆÂø¡C</para></listitem>
- <listitem><para>Provide mechanism, rather than policy. In
- particular, place user interface policy in the client's
- hands.</para></listitem>
+ <listitem><para>´£¨Ñ¾÷¨î(mechanism)¡A¦Ó«Dì«h(policy)¡C
+ ¤ñ¤è»¡¡A§â¨Ï¥ÎªÌ¤¶±¿ï¾ÜÅv¥æ¥Ñ¨Ï¥ÎªÌ¨Ó¨M©w¡C</para></listitem>
</itemizedlist>
- <para>From Scheifler & Gettys: "X Window System"</para>
+ <para>¥H¤WºK¦Û Scheifler & Gettys ªº "X Window System" ½×¤å</para>
</sect1>
<sect1 id="introduction-layout">
- <title>The Layout of
- <filename class="directory">/usr/src</filename></title>
+ <title><filename class="directory">/usr/src</filename> ªº¬[ºc</title>
- <para>The complete source code to FreeBSD is available from our
- public CVS repository. The source code is normally installed in
- <filename class="directory">/usr/src</filename> which contains the
- following subdirectories:</para>
+ <para>
+ §¹¾ãªº FreeBSD ì©l½X³£¦b¤½¶}ªº CVS repository ¤¤¡C
+ ³q±` FreeBSD ì©l½X³£·|¸Ë¦b <filename class="directory">/usr/src</filename>¡A
+ ¦Ó¥B¥]§t¤U¦C¤l¥Ø¿ý¡G
+ </para>
<para>
<informaltable frame="none" pgwide="1">
==== //depot/projects/dtrace/doc/zh_TW.Big5/books/developers-handbook/tools/chapter.sgml#2 (text+ko) ====
@@ -1,7 +1,8 @@
<!--
The FreeBSD Documentation Project
- $FreeBSD: doc/zh_TW.Big5/books/developers-handbook/tools/chapter.sgml,v 1.1 2006/06/17 10:22:44 vanilla Exp $
+ $FreeBSD: doc/zh_TW.Big5/books/developers-handbook/tools/chapter.sgml,v 1.2 2006/07/26 03:56:43 vanilla Exp $
+ Original revision: 1.46
-->
<chapter id="tools">
@@ -19,127 +20,111 @@
</authorgroup>
</chapterinfo>
- <title>Programming Tools</title>
- <sect1 id="tools-synopsis"><title>Synopsis</title>
+ <title>µ{¦¡¶}µo¤u¨ã</title>
+ <sect1 id="tools-synopsis"><title>·§±Ô</title>
- <para>This chapter is an introduction to using some of the
- programming tools supplied with FreeBSD, although much of it
- will be applicable to many other versions of &unix;. It does
- <emphasis>not</emphasis> attempt to describe coding in any
- detail. Most of the chapter assumes little or no previous
- programming knowledge, although it is hoped that most
- programmers will find something of value in it.</para>
+ <para>
+ ¥»³¹±N¤¶²Ð¦p¦ó¨Ï¥Î¤@¨Ç FreeBSD ©Ò´£¨Ñªºµ{¦¡¶}µo¤u¨ã(programing tools)¡A
+ ¥»³¹©Ò¤¶²Ðªº¤u¨ãµ{¦¡¦b¨ä¥Lª©¥»ªº &unix; ¤W¤]¥i¨Ï¥Î¡A
+ ¦b¦¹ <emphasis>¨Ã¤£·|</emphasis> ¹Á¸Õ´yz¼gµ{¦¡®Éªº¨CÓ²Ó¸`¡A
+ ¥»³¹¤j³¡¤À½g´T³£¬O°²³]§A¥H«e¨S¦³©Î¥u¦³¤Ö¼Æªº¼gµ{¦¡¸gÅç¡A
+ ¤£¹L¡AÁÙ¬O§Æ±æ¤j¦h¼Æªºµ{¦¡¶}µo¤Hû³£¯à±q¤¤«·s±o¨ì¤@¨Ç±Òµo¡C
+ </para>
</sect1>
- <sect1 id="tools-intro"><title>Introduction</title>
+ <sect1 id="tools-intro"><title>²¤¶</title>
- <para>FreeBSD offers an excellent development environment.
- Compilers for C, C++, and Fortran and an assembler come with the
- basic system, not to mention a Perl interpreter and classic &unix;
- tools such as <command>sed</command> and <command>awk</command>.
- If that is not enough, there are many more compilers and
- interpreters in the Ports collection. FreeBSD is very
- compatible with standards such as <acronym>&posix;</acronym> and
- <acronym>ANSI</acronym> C, as well with its own BSD heritage, so
- it is possible to write applications that will compile and run
- with little or no modification on a wide range of
- platforms.</para>
+ <para>
+ FreeBSD ´£¨Ñ¤@Ó«D±`´Îªº¶}µoÀô¹Ò¡A
+ ¤ñ¦p»¡¹³¬O C¡BC++¡BFortran ©M assembler(²Õ¦X»y¨¥)ªº½sĶ¾¹(compiler),
+ ¦b FreeBSD ¤¤³£¤w¸g¥]§t¦b°ò¥»ªº¨t²Î¤¤¤F
+ §ó§O´£ Perl ©M¨ä¥L¼Ð·Ç &unix; ¤u¨ã¡A¹³¬O<command>sed</command> ¥H¤Î <command>awk</command>¡A
+ ¦pªG§AÁÙ¬Oı±o¤£°÷¡AFreeBSD¦b Ports collection ¤¤ÁÙ´£¨Ñ¨ä¥Lªº½sĶ¾¹©Mª½Ä¶¾¹(interpreter),
+ FreeBSD ¬Û®e³\¦h¼Ð·Ç¡A¹³¬O <acronym>&posix;</acronym> ©M <acronym>ANSI</acronym> C¡A
+ ·íµMÁÙ¦³¥¦©ÒÄ~©Óªº BSD ¶Ç²Î¡C
+ ©Ò¥H¦b FreeBSD ¤W¼gªºµ{¦¡¤£»Ýקï©Î³»¦hµy·Lקï¡A´N¥i¥H¦b³\¦h¥¥x¤W½sĶ¡B°õ¦æ¡C
+ </para>
- <para>However, all this power can be rather overwhelming at first
- if you have never written programs on a &unix; platform before.
- This document aims to help you get up and running, without
- getting too deeply into more advanced topics. The intention is
- that this document should give you enough of the basics to be
- able to make some sense of the documentation.</para>
+ <para>
+ µL½×¦p¦ó¡A´Nºâ§A±q¨Ó¨S¦b &unix; ¥¥x¤W¼g¹Lµ{¦¡¡A¤]¥i¥H¹ý©³·P¨ü¨ìFreeBSD ¥O¤HµLªk§Ü©Úªº°g¤HÅ]¤O¡C
+ ¥»³¹ªº¥Ø¼Ð´N¬O¨ó§U§A§Ö³t¤W¤â¡A¦Ó¼È®É¤£»Ý²`¤J¤Ó¦h¶i¶¥¥DÃD¡A
+ ¨Ã¥BÁ¿¸Ñ¤@¨Ç°ò¦·§©À¡A¥HÅý§A¥i¥HÁA¸Ñ§Ú̦bÁ¿¨Ç¤°»ò¡C
+ </para>
- <para>Most of the document requires little or no knowledge of
- programming, although it does assume a basic competence with
- using &unix; and a willingness to learn!</para>
+ <para>
+ ¥»³¹¤º®e¨Ã¤£n¨D§A±o¦³µ{¦¡¶}µo¸gÅç¡A©ÎªÌ§A¥u¦³¤@ÂIÂIªº¸gÅç¦Ó¤w¡C
+ ¤£¹L¡A§ÚÌ°²³]§A¤w¸g·| &unix; ¨t²Îªº°ò¥»¾Þ§@¡A
+ ¦Ó¥B§ó«nªº¬O¡A½Ð«O«ù¼Ö©ó¾Ç²ßªº¤ßºA¡I
+ </para>
</sect1>
<sect1 id="tools-programming">
- <title>Introduction to Programming</title>
+ <title>Programming ·§©À</title>
- <para>A program is a set of instructions that tell the computer to
- do various things; sometimes the instruction it has to perform
- depends on what happened when it performed a previous
- instruction. This section gives an overview of the two main
- ways in which you can give these instructions, or
- <quote>commands</quote> as they are usually called. One way
- uses an <firstterm>interpreter</firstterm>, the other a
- <firstterm>compiler</firstterm>. As human languages are too
- difficult for a computer to understand in an unambiguous way,
- commands are usually written in one or other languages specially
- designed for the purpose.</para>
+ <para>
+ ²³æªº»¡¡Aµ{¦¡¥u¬O¤@°ï«ü¥Oªº¶°¦XÅé¡F¦Ó³o¨Ç«ü¥O¬O¥Î¨Ó§i¶D¹q¸£À³¸Ón§@¨º¨Ç¨Æ±¡¡C
+ ¦³®ÉÔ¡A«ü¥Oªº°õ¦æ¨ú¨M©ó«e¤@Ó«ü¥Oªºµ²ªG¦Ó©w¡C
+ ¥»³¹±N·|§i¶D§A¦³ 2 Ó¥Dnªº¤èªk¡AÅý§A¥i¥H¹ï¹q¸£¤U¹F³o¨Ç«ü¥Ü(instruction) ©Î <quote>©R¥O(commands)</quote>¡C
+ ²Ä¤@Ó¤èªk´N¬O <firstterm>ª½Ä¶¾¹(interpreter)</firstterm>¡A
+ ¦Ó²Ä¤GÓ¤èªk¬O <firstterm>½sĶ¾¹(compiler)</firstterm>¡C
+ ¥Ñ©ó¹ï©ó¹q¸£¦Ó¨¥¡A¤HÃþ»y¨¥ªº»y·N¹L©ó¼Ò½k¦Ó¤ÓÃø²z¸Ñ¡A
+ ¦]¦¹©R¥O(commands)´N±`·|¥H¤@ºØ(©Î¦hºØ)µ{¦¡»y¨¥¼g¦¨¡A¥Î¨Ó«ü¥Ü¹q¸£©Òn°õ¦æªº¯S©w°Ê§@¬°¦ó¡C
+ </para>
<sect2>
- <title>Interpreters</title>
+ <title>ª½Ä¶¾¹</title>
- <para>With an interpreter, the language comes as an environment,
- where you type in commands at a prompt and the environment
- executes them for you. For more complicated programs, you can
- type the commands into a file and get the interpreter to load
- the file and execute the commands in it. If anything goes
- wrong, many interpreters will drop you into a debugger to help
- you track down the problem.</para>
+ <para>
+ ¨Ï¥Îª½Ä¶¾¹®É¡A©Ò¨Ï¥Îªºµ{¦¡»y¨¥´N¹³Åܦ¨¤@Ó·|©M§A¤¬°ÊªºÀô¹Ò¡C
+ ·í¦b©R¥O´£¥Ü¦C¤W¥´¤W©R¥O®É¡Aª½Ä¶¾¹·|§Y®É°õ¦æ¸Ó©R¥O¡C
+ ¦b¤ñ¸û½ÆÂøªºµ{¦¡¤¤¡A¥i¥H§â©Ò¦³·Q¤U¹Fªº©R¥O²Î²Î¿é¤J¨ì¬YÀɮ׸̱¥h¡A
+ µM«á©I¥sª½Ä¶¾¹¥hŪ¨ú¸ÓÀɮסA¨Ã¥B°õ¦æ§A¼g¦b³oÓÀɮפ¤ªº«ü¥O¡C
+ ¦pªG©Ò¤Uªº«ü¥O¦³¿ù»~²£¥Í¡A¤j¦h¼Æªºª½Ä¶¾¹·|¶i¤J°»¿ù¼Ò¦¡(debugger)¡A
+ ¨Ã¥BÅã¥Ü¬ÛÃö¿ù»~°T®§¡A¥H«K¹ïµ{¦¡°£¿ù¡C
+ </para>
- <para>The advantage of this is that you can see the results of
- your commands immediately, and mistakes can be corrected
- readily. The biggest disadvantage comes when you want to
- share your programs with someone. They must have the same
- interpreter, or you must have some way of giving it to them,
- and they need to understand how to use it. Also users may not
- appreciate being thrown into a debugger if they press the
- wrong key! From a performance point of view, interpreters can
- use up a lot of memory, and generally do not generate code as
- efficiently as compilers.</para>
+ <para>
+ ³oºØ¤è¦¡¦n³B¦b©ó¡G¥i¥H¥ß¨è¬Ý¨ì«ü¥Oªº°õ¦æµ²ªG¡A¥H¤Î¿ù»~¤]¥i¨³³t×¥¿¡C
+ ¬Û¹ïªº¡A³Ì¤jªºÃa³B«K¬O·í§A·Q§â§A¼gªºµ{¦¡¤À¨Éµ¹¨ä¥L¤H®É¡A³o¨Ç¤H¥²¶·n¦³¸ò§A¤@¼Ëªºª½Ä¶¾¹¡C
+ ¦Ó¥B§O§Ñ¤F¡A¥L̤]n·|¨Ï¥Îª½Ä¶¾¹ª½Ä¶µ{¦¡¤~¦æ¡C
+ ·íµM¨Ï¥ÎªÌ¤]¤£§Æ±æ¤£¤p¤ß«ö¿ùÁä¡A´N¶i¤J°»¿ù¼Ò¦¡¦Ó¤£ª¾©Ò±¹¡C
+ ´N°õ¦æ®Ä²v¦Ó¨¥¡Aª½Ä¶¾¹·|¨Ï¥Î¨ì«Ü¦hªº°O¾ÐÅé¡A
+ ¦Ó¥B³oÃþª½Ä¶¦¡µ{¦¡¡A³q±`¨Ã¤£·|¤ñ½sĶ¾¹©Ò½sĶªºµ{¦¡ªº§ó¦³®Ä²v¡C
+ </para>
- <para>In my opinion, interpreted languages are the best way to
- start if you have not done any programming before. This kind
- of environment is typically found with languages like Lisp,
- Smalltalk, Perl and Basic. It could also be argued that the
- &unix; shell (<command>sh</command>, <command>csh</command>) is itself an
- interpreter, and many people do in fact write shell
- <quote>scripts</quote> to help with various
- <quote>housekeeping</quote> tasks on their machine. Indeed, part
- of the original &unix; philosophy was to provide lots of small
- utility programs that could be linked together in shell
- scripts to perform useful tasks.</para>
+ <para>
+ µ§ªÌÓ¤H»{¬°¡A¦pªG§A¤§«e¨S¦³¾Ç¹L¥ô¦óµ{¦¡»y¨¥¡A³Ì¦n¥ý¾Ç¾Ç²ßª½Ä¶¦¡»y¨¥(interpreted languages)¡A
+ ¹³¬O Lisp¡ASmalltalk¡APerl ©M Basic ³£¬O¡A&unix; ªº shell ¹³¬O <command>sh</command> ©M <command>csh</command>
+ ¥¦Ì¥»¨´N¬Oª½Ä¶¾¹¡A¨Æ¹ê¤W¡A«Ü¦h¤H³£¦b¥¦Ì¦Û¤v¾÷¾¹¤W¼¶¼g¦U¦¡ªº shell <quote>script</quote>¡A
+ ¨Ó¶¶§Q§¹¦¨¦U¶µ <quote>housekeeping(ºûÅ@)</quote> ¥ô°È¡C
+ &unix; ¨Ï¥Îõ¾Ç¤§¤@´N¬O´£¨Ñ¤j¶qªº¤p¤u¨ã¡A
+ ¨Ã¨Ï¥Î shell script ¨Ó²Õ¦X¹B¥Î³o¨Ç¤p¤u¨ã¡A¥H«K¤u§@§ó¦³®Ä²v¡C
</sect2>
<sect2>
- <title>Interpreters available with FreeBSD</title>
+ <title>FreeBSD ´£¨Ñªºª½Ä¶¾¹</title>
- <para>Here is a list of interpreters that are available from
- the &os; Ports Collection, with a brief discussion of
- some of the more popular interpreted languages.</para>
+ <para>
+ ¤U±³oÃ䦳¥÷ &os; Ports Collection ©Ò´£¨Ñªºª½Ä¶¾¹²M³æ¡AÁÙ¦³°Q½×¤@¨Ç¤ñ¸û¨üÅwªïªºª½Ä¶¦¡»y¨¥</para>
- <para>Instructions on how to get and install applications
- from the Ports Collection can be found in the
- <ulink url="&url.books.handbook;/ports-using.html">
- Ports section</ulink> of the handbook.
-
+ <para>
+ ¦Ü©ó¦p¦ó¨Ï¥Î Ports Collection ¦w¸Ëªº»¡©ú¡A¥i°Ñ¾\ FreeBSD Handbook ¤¤ªº
+ <ulink url="&url.books.handbook;/ports-using.html">Ports³¹¸`</ulink>¡C
<variablelist>
<varlistentry>
<term><acronym>BASIC</acronym></term>
<listitem>
- <para>Short for Beginner's All-purpose Symbolic
- Instruction Code. Developed in the 1950s for teaching
- University students to program and provided with every
- self-respecting personal computer in the 1980s,
- <acronym>BASIC</acronym> has been the first programming
- language for many programmers. It is also the foundation
- for Visual Basic.</para>
+ <para>BASIC ¬O Beginner's ALL-purpose Symbolic Instruction Code ªºÁY¼g¡C
+ BASIC ©ó 1950 ¦~¥N¶}©lµo®i¡A³Ìªì¶}µo³o®M»y¨¥ªº¥Øªº¬O¬°¤F±Ð¾É·í®Éªº¤j¾Ç¾Ç¥Í¦p¦ó¼gµ{¦¡¡C
+ ¨ì¤F 1980¡A<acronym>BASIC</acronym>¤w¸g¬O«Ü¦h programmer ²Ä¤@ӾDzߪºµ{¦¡»y¨¥¤F¡C
+ ¦¹¥~¡ABASIC ¤]¬O Visual Basic ªº°ò¦¡C</para>
- <para>The Bywater Basic Interpreter can be found in the
- Ports Collection as
- <filename role="package">lang/bwbasic</filename>
- and the Phil Cockroft's Basic Interpreter
- (formerly Rabbit Basic) is available as
- <filename role="package">lang/pbasic</filename>.</para>
+ <para>FreeBSD Ports Collection ¤]¦³¦¬¿ý¬ÛÃöªº BASIC ª½Ä¶¾¹¡C
+ Bywater Basic ª½Ä¶¾¹©ñ¦b <filename role="package">lang/bwbasic</filename>¡C
+ ¦Ó Phil Cockroft's Basic ª½Ä¶¾¹(¦´Á¤]¥s Rabbit Basic)©ñ¦b <filename role="package">lang/pbasic</filename>¡C
</listitem>
</varlistentry>
@@ -147,29 +132,22 @@
<term>Lisp</term>
<listitem>
- <para>A language that was developed in the late 1950s as
- an alternative to the <quote>number-crunching</quote>
>>> TRUNCATED FOR MAIL (1000 lines) <<<
More information about the p4-projects
mailing list