From owner-svn-doc-all@freebsd.org Thu Sep 7 11:56:19 2017 Return-Path: Delivered-To: svn-doc-all@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 030CFE1A3EA; Thu, 7 Sep 2017 11:56:19 +0000 (UTC) (envelope-from mat@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 6F95280361; Thu, 7 Sep 2017 11:56:18 +0000 (UTC) (envelope-from mat@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id v87BuHmj016079; Thu, 7 Sep 2017 11:56:17 GMT (envelope-from mat@FreeBSD.org) Received: (from mat@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id v87BuHFI016072; Thu, 7 Sep 2017 11:56:17 GMT (envelope-from mat@FreeBSD.org) Message-Id: <201709071156.v87BuHFI016072@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: mat set sender to mat@FreeBSD.org using -f From: Mathieu Arnold Date: Thu, 7 Sep 2017 11:56:17 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r50805 - in head/en_US.ISO8859-1: articles/fonts articles/freebsd-update-server articles/hubs books/developers-handbook/ipv6 books/developers-handbook/tools books/handbook/network-serve... X-SVN-Group: doc-head X-SVN-Commit-Author: mat X-SVN-Commit-Paths: in head/en_US.ISO8859-1: articles/fonts articles/freebsd-update-server articles/hubs books/developers-handbook/ipv6 books/developers-handbook/tools books/handbook/network-servers books/handbook/virtua... X-SVN-Commit-Revision: 50805 X-SVN-Commit-Repository: doc MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 07 Sep 2017 11:56:19 -0000 Author: mat Date: Thu Sep 7 11:56:16 2017 New Revision: 50805 URL: https://svnweb.freebsd.org/changeset/doc/50805 Log: Fix some extra spacing in screen entries. While there, replace some with programlisting when more suited. Sponsored by: Absolight Modified: head/en_US.ISO8859-1/articles/fonts/article.xml head/en_US.ISO8859-1/articles/freebsd-update-server/article.xml head/en_US.ISO8859-1/articles/hubs/article.xml head/en_US.ISO8859-1/books/developers-handbook/ipv6/chapter.xml head/en_US.ISO8859-1/books/developers-handbook/tools/chapter.xml head/en_US.ISO8859-1/books/handbook/network-servers/chapter.xml head/en_US.ISO8859-1/books/handbook/virtualization/chapter.xml Modified: head/en_US.ISO8859-1/articles/fonts/article.xml ============================================================================== --- head/en_US.ISO8859-1/articles/fonts/article.xml Thu Sep 7 11:21:07 2017 (r50804) +++ head/en_US.ISO8859-1/articles/fonts/article.xml Thu Sep 7 11:56:16 2017 (r50805) @@ -307,7 +307,7 @@ look like: - -bitstream-charter-medium-r-normal-xxx-0-0-0-0-p-0-iso8859-1 + -bitstream-charter-medium-r-normal-xxx-0-0-0-0-p-0-iso8859-1 | | | | | | | | | | | | \ \ | | | | | \ \ \ \ \ \ \ +----+- character set | | | | \ \ \ \ \ \ \ +- average width @@ -317,7 +317,7 @@ | | | \ \ \ \ +- points | | | \ \ \ +- pixels | | | \ \ \ - foundry family weight slant width additional style + foundry family weight slant width additional style A new name needs to be created for each new font. If you @@ -438,8 +438,7 @@ end readonly def simply using - …-normal-r-normal-…-p-… - + …-normal-r-normal-…-p-… as the name, and then use @@ -725,8 +724,7 @@ EOF In the work area, you will need to make the utility. Just type: - # make -f Makefile.sub afmtodit - + # make -f Makefile.sub afmtodit You may also need to copy /usr/contrib/groff/devps/generate/textmap @@ -745,8 +743,7 @@ EOF Create the .afm file by typing: - % gs -dNODISPLAY -q -- ttf2pf.ps TTF_name PS_font_name AFM_name - + % gs -dNODISPLAY -q -- ttf2pf.ps TTF_name PS_font_name AFM_name Where, TTF_name is your TrueType font file, PS_font_name @@ -770,8 +767,7 @@ EOF Aladdin Ghostscript 5.10 (1997-11-23) Copyright (C) 1997 Aladdin Enterprises, Menlo Park, CA. All rights reserved. This software comes with NO WARRANTY: see the file PUBLIC for details. -Converting 3of9.ttf to 3of9.pfa and 3of9.afm. - +Converting 3of9.ttf to 3of9.pfa and 3of9.afm. If you want the converted fonts to be stored in A.pfa and B.afm, @@ -781,8 +777,7 @@ Converting 3of9.ttf to 3of9.pfa and 3of9.afm. Aladdin Ghostscript 5.10 (1997-11-23) Copyright (C) 1997 Aladdin Enterprises, Menlo Park, CA. All rights reserved. This software comes with NO WARRANTY: see the file PUBLIC for details. -Converting 3of9.ttf to A.pfa and B.afm. - +Converting 3of9.ttf to A.pfa and B.afm. @@ -798,9 +793,7 @@ Converting 3of9.ttf to A.pfa and B.afm. generate/textmap as being in this directory.) - % afmtodit -d DESC -e text.enc file.afm \ - generate/textmap PS_font_name - + % afmtodit -d DESC -e text.enc file.afm generate/textmap PS_font_name Where, file.afm is the AFM_name created by @@ -812,10 +805,8 @@ Converting 3of9.ttf to A.pfa and B.afm. tiff2pf.ps command above, then the 3of9 Barcode font can be created using the command: - % afmtodit -d DESC -e text.enc 3of9.afm \ - generate/textmap 3of9 - - + % afmtodit -d DESC -e text.enc 3of9.afm generate/textmap 3of9 + Ensure that the resulting PS_font_name file (e.g., 3of9 in the example above) is located Modified: head/en_US.ISO8859-1/articles/freebsd-update-server/article.xml ============================================================================== --- head/en_US.ISO8859-1/articles/freebsd-update-server/article.xml Thu Sep 7 11:21:07 2017 (r50804) +++ head/en_US.ISO8859-1/articles/freebsd-update-server/article.xml Thu Sep 7 11:56:16 2017 (r50805) @@ -785,15 +785,15 @@ the new builds. release and architecture and you are ready to build off your custom release. - # Compare ${WORKDIR}/release and ${WORKDIR}/$1, identify which parts - # of the world|doc subcomponent are missing from the latter, and - # build a tarball out of them. - findextradocs () { - } + # Compare ${WORKDIR}/release and ${WORKDIR}/$1, identify which parts +# of the world|doc subcomponent are missing from the latter, and +# build a tarball out of them. +findextradocs () { +} - # Add extra docs to ${WORKDIR}/$1 - addextradocs () { - } +# Add extra docs to ${WORKDIR}/$1 +addextradocs () { +} Adding - # Build the world + # Build the world log "Building world" cd /usr/src && make -j 2 ${COMPATFLAGS} buildworld 2>&1 @@ -815,7 +815,7 @@ the new builds. log "Distributing world" cd /usr/src/release && make -j 2 obj && - make ${COMPATFLAGS} release.1 release.2 2>&1 + make ${COMPATFLAGS} release.1 release.2 2>&1 @@ -826,9 +826,9 @@ the new builds. update mirrors, however this tip is not necessary unless you wish to provide a redundant service. - _http._tcp.update.myserver.com. IN SRV 0 2 80 host1.myserver.com. - SRV 0 1 80 host2.myserver.com. - SRV 0 0 80 host3.myserver.com. + _http._tcp.update.myserver.com. IN SRV 0 2 80 host1.myserver.com. + IN SRV 0 1 80 host2.myserver.com. + IN SRV 0 0 80 host3.myserver.com. Modified: head/en_US.ISO8859-1/articles/hubs/article.xml ============================================================================== --- head/en_US.ISO8859-1/articles/hubs/article.xml Thu Sep 7 11:21:07 2017 (r50804) +++ head/en_US.ISO8859-1/articles/hubs/article.xml Thu Sep 7 11:56:16 2017 (r50805) @@ -305,8 +305,7 @@ A command line to mirror FreeBSD might look like: - &prompt.user; rsync -vaHz --delete rsync://ftp4.de.FreeBSD.org/FreeBSD/ /pub/FreeBSD/ - + &prompt.user; rsync -vaHz --delete rsync://ftp4.de.FreeBSD.org/FreeBSD/ /pub/FreeBSD/ Consult the documentation for rsync, which is also available at http://rsync.samba.org/, @@ -325,8 +324,7 @@ The FreeBSD website should only be mirrored via rsync. A command line to mirror the FreeBSD web site might look like: - &prompt.user; rsync -vaHz --delete rsync://bit0.us-west.freebsd.org/FreeBSD-www-data/ /usr/local/www/ - + &prompt.user; rsync -vaHz --delete rsync://bit0.us-west.freebsd.org/FreeBSD-www-data/ /usr/local/www/ Mirroring Packages Modified: head/en_US.ISO8859-1/books/developers-handbook/ipv6/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/developers-handbook/ipv6/chapter.xml Thu Sep 7 11:21:07 2017 (r50804) +++ head/en_US.ISO8859-1/books/developers-handbook/ipv6/chapter.xml Thu Sep 7 11:56:16 2017 (r50805) @@ -382,8 +382,7 @@ example, you may see something like: - fe80:1::200:f8ff:fe01:6317 - + fe80:1::200:f8ff:fe01:6317 in the routing table and interface address structure (struct in6_ifaddr). The address above is a link-local unicast address @@ -831,8 +830,7 @@ fe80:2::%ep0/64 link#2 lo0 = 8 cce0 = 10 3282 one ext mbuf - 0 two or more ext mbuf - + 0 two or more ext mbuf Each input function calls IP6_EXTHDR_CHECK in the beginning to check if the region between IP6 and its header is continuous. @@ -875,8 +873,7 @@ fe80:2::%ep0/64 link#2 socket gets IPv4 conn.) --- --- FreeBSD 4.x configurable supported - default: enabled - + default: enabled The following sections will give you more details, and how you can configure the behavior. @@ -921,11 +918,10 @@ FreeBSD 4.x configurable supported To resolve this issue more easily, there is system dependent &man.setsockopt.2; option, IPV6_BINDV6ONLY, used like below. - int on; + int on; setsockopt(s, IPPROTO_IPV6, IPV6_BINDV6ONLY, - (char *)&on, sizeof (on)) < 0)); - + (char *)&on, sizeof (on)) < 0)); When this call succeed, then this socket only receive IPv6 packets. @@ -1015,11 +1011,10 @@ FreeBSD 4.x configurable supported wildcard bind (enabled by default). You can disable it on each socket basis with &man.setsockopt.2; like below. - int on; + int on; setsockopt(s, IPPROTO_IPV6, IPV6_BINDV6ONLY, - (char *)&on, sizeof (on)) < 0)); - + (char *)&on, sizeof (on)) < 0)); Wildcard AF_INET6 socket grabs IPv4 connection if and only if the following conditions are satisfied: @@ -1062,21 +1057,19 @@ FreeBSD 4.x configurable supported As a result, RFC2553 defines struct sockaddr_storage as follows: - struct sockaddr_storage { + struct sockaddr_storage { u_char __ss_len; /* address length */ u_char __ss_family; /* address family */ /* and bunch of padding */ - }; - + }; On the contrary, XNET draft defines as follows: - struct sockaddr_storage { + struct sockaddr_storage { u_char ss_len; /* address length */ u_char ss_family; /* address family */ /* and bunch of padding */ - }; - + }; In December 1999, it was agreed that RFC2553bis should pick the latter (XNET) definition. @@ -1103,9 +1096,8 @@ FreeBSD 4.x configurable supported never touch __ss_family. cast to sockaddr * and use sa_family like: - struct sockaddr_storage ss; - family = ((struct sockaddr *)&ss)->sa_family - + struct sockaddr_storage ss; + family = ((struct sockaddr *)&ss)->sa_family @@ -1197,8 +1189,7 @@ FreeBSD 4.x configurable supported FAITH-relay dual stack node ^ | IPv6 TCP toward 2001:0DB8:0200:ffff::163.221.202.12 - source IPv6 node - + source IPv6 node &man.faithd.8; must be invoked on FAITH-relay dual stack node. @@ -1519,9 +1510,7 @@ ECN forbidden copy TOS bits except for ECN drop T ECN allowed copy TOS bits except for ECN use inner TOS bits with some CE (masked with 0xfe) from change. if outer ECN CE bit inner to outer. is 1, enable ECN CE bit on - set ECN CE bit to 0. the inner. - - + set ECN CE bit to 0. the inner. General strategy for configuration is as follows: Modified: head/en_US.ISO8859-1/books/developers-handbook/tools/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/developers-handbook/tools/chapter.xml Thu Sep 7 11:21:07 2017 (r50804) +++ head/en_US.ISO8859-1/books/developers-handbook/tools/chapter.xml Thu Sep 7 11:56:16 2017 (r50805) @@ -440,8 +440,7 @@ &prompt.user; cc foobar.c executable is a.out -&prompt.user; cc -o foobar foobar.c executable is foobar - +&prompt.user; cc -o foobar foobar.c executable is foobar @@ -455,8 +454,7 @@ you are using a Makefile. - &prompt.user; cc -c foobar.c - + &prompt.user; cc -c foobar.c This will produce an object file (not an @@ -483,8 +481,7 @@ satisfied it works properly. - &prompt.user; cc -g foobar.c - + &prompt.user; cc -g foobar.c This will produce a debug version of the @@ -513,8 +510,7 @@ compiler's optimizer. - &prompt.user; cc -O -o foobar foobar.c - + &prompt.user; cc -O -o foobar foobar.c This will produce an optimized version of @@ -610,8 +606,7 @@ line. - &prompt.user; cc -o foobar foobar.c -lm - + &prompt.user; cc -o foobar foobar.c -lm This will link the math library functions into @@ -643,8 +638,7 @@ like this. What does it mean? - /var/tmp/cc0143941.o: Undefined symbol `_sin' referenced from text segment - + /var/tmp/cc0143941.o: Undefined symbol `_sin' referenced from text segment @@ -655,8 +649,7 @@ so: - &prompt.user; cc -o foobar foobar.c -lm - + &prompt.user; cc -o foobar foobar.c -lm @@ -683,8 +676,7 @@ int main() { and I compiled it as: - &prompt.user; cc temp.c -lm - + &prompt.user; cc temp.c -lm like you said I should, but I get this when I run @@ -692,8 +684,7 @@ int main() { &prompt.user; ./a.out -2.1 ^ 6 = 1023.000000 - +2.1 ^ 6 = 1023.000000 This is not the right answer! @@ -735,8 +726,7 @@ int main() { &prompt.user; ./a.out -2.1 ^ 6 = 85.766121 - +2.1 ^ 6 = 85.766121 If you are using any of the mathematical functions, @@ -762,8 +752,7 @@ int main() { option: - &prompt.user; cc -o foobar foobar.c - + &prompt.user; cc -o foobar foobar.c @@ -803,8 +792,7 @@ int main() { checking the current directory. Either type: - &prompt.user; ./test - + &prompt.user; ./test or choose a better name for your program! @@ -960,14 +948,12 @@ free(foo); Yes, just go to another console or xterm, do - &prompt.user; ps - + &prompt.user; ps to find out the process ID of your program, and do - &prompt.user; kill -ABRT pid - + &prompt.user; kill -ABRT pid where pid is @@ -1589,7 +1575,7 @@ Cannot access memory at address 0x7020796d. not, gentle reader, here is how to do it (courtesy of the gdb info pages): - … + … if ((pid = fork()) < 0) /* _Always_ check this */ error(); else if (pid == 0) { /* child */ @@ -1599,7 +1585,7 @@ else if (pid == 0) { /* child */ sleep(10); /* Wait until someone attaches to us */ … } else { /* parent */ - … + … Now all you have to do is attach to the child, set PauseMode to 0, and wait @@ -1821,8 +1807,7 @@ else if (pid == 0) { /* child */ if you are doing something outside Emacs and you want to edit a file, you can just type in - &prompt.user; emacsclient filename - + &prompt.user; emacsclient filename and then you can edit the file in your Emacs! Modified: head/en_US.ISO8859-1/books/handbook/network-servers/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/network-servers/chapter.xml Thu Sep 7 11:21:07 2017 (r50804) +++ head/en_US.ISO8859-1/books/handbook/network-servers/chapter.xml Thu Sep 7 11:56:16 2017 (r50805) @@ -4244,9 +4244,7 @@ $include Kexample.com.+005+nnnnn.ZSK.key ; ZSKexample.com.db would look similar to - &prompt.user; dnssec-signzone -o - example.com -k Kexample.com.+005+nnnnn.KSK example.com.db - Kexample.com.+005+nnnnn.ZSK.key + &prompt.user; dnssec-signzone -o example.com -k Kexample.com.+005+nnnnn.KSK example.com.db Kexample.com.+005+nnnnn.ZSK.key The key supplied to the argument is the KSK and the other key file is Modified: head/en_US.ISO8859-1/books/handbook/virtualization/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/virtualization/chapter.xml Thu Sep 7 11:21:07 2017 (r50804) +++ head/en_US.ISO8859-1/books/handbook/virtualization/chapter.xml Thu Sep 7 11:56:16 2017 (r50805) @@ -932,8 +932,7 @@ perm vboxnetctl 0660 machine, the user needs to be a member of the operator group. - &prompt.root; pw groupmod operator -m - yourusername + &prompt.root; pw groupmod operator -m yourusername Restart the login session and &virtualbox; for these changes to take