A quick tutorial on FreeBSD Document Project

1. FreeBSD
Docbook/SGML
chinsan@FreeBSD.org
http://people.freebsd.org/~chinsan/doc/fdp.pdf

3. •

4. •
• Open Source

5. •
• Open Source
•

6. •
• Open Source
•
• :

7. FDP?

8. FDP?
FreeBSD Document Project

9. FDP?
FreeBSD Document Project
FDP Primer is Your friend

10. FDP?
FreeBSD Document Project
FDP Primer is Your friend
FDP
https://opensvn.csie.org/traccgi/freebsddoc/wiki

11. FDP?
FreeBSD Document Project
FDP Primer is Your friend
FDP
https://opensvn.csie.org/traccgi/freebsddoc/wiki
FDP Primer
http://www.freebsd.org/doc/zh_TW/books/fdp-primer/

12. FDP
• Manual
• FAQ
• Handbook
• Web Site

13. to get FDP Tool-chain

14. because you've
got port tree
http://www.freebsd.org/ports/growth/status.png (2007/11/01)

15. because you've
got port tree
http://www.freebsd.org/ports/growth/status.png (2007/11/01)

16. because you've
got port tree
ȣ

17. ཞȣ

18. ཞ
http://www.freebsd.org/ports/growth/status.png (2007/11/01)

21. PostScript(PS) PDF
JadeTeX (
WITH_JADETEX=yes )

22. Get doc/ tree

23. Get doc/ tree
• anonymous CVS

24. Get doc/ tree
• anonymous CVS
• CVSup client
cvsup or csup(6.2-R )

25. Get doc/ tree
• anonymous CVS
• CVSup client
cvsup or csup(6.2-R )
• CVSup
mirror

26. Get doc/ tree
• anonymous CVS
• CVSup client
cvsup or csup(6.2-R )
• CVSup
mirror
• CVSup csup

27. /etc/make.conf

28. /etc/make.conf
•
SUPHOST= cvsup.tw.FreeBSD.org
SUP_UPDATE= yes
DOCSUPFILE= /usr/share/examples/cvsup/doc-supfile

29. /etc/make.conf
•
SUPHOST= cvsup.tw.FreeBSD.org
SUP_UPDATE= yes
DOCSUPFILE= /usr/share/examples/cvsup/doc-supfile
• SUPHOST
cvsup.tw cron
(DDoS..* *).... :p

30. /etc/make.conf
•
SUPHOST= cvsup.tw.FreeBSD.org
SUP_UPDATE= yes
DOCSUPFILE= /usr/share/examples/cvsup/doc-supfile
• SUPHOST
cvsup.tw cron
(DDoS..* *).... :p
•
cd /usr/doc ; make update

31. • sysutils/fastest_cvsup
fastest_cvsup -Q -c all

33. Docbook/SGML

34. Version Control System

35. Version Control System
Offical FDP: CVS

36. Version Control System
Offical FDP: CVS
Traditional-Chinese FDP: we use Subversion(SVN)+Trac(for
bug tracking system and wiki) which supplied by
OpenSVN.csie.org
ps.thanks for their effort to maintain OpenSVN. :)

38. https://opensvn.csie.org/traccgi/freebsddoc/wiki

40. http://freebsddoc.twbbs.org

42. ...

44. ....!!

45. ....!!

47. ..

48. : KERORO

50. ...

53. send-pr !!

56. header

57. header

58. header

59. patch(unified
diff ) CC

60. ports/ PR
• ports-mgmt/porttools

61. PR
• FreBSD PR feedback 1
• maintainer feedback 2
• followup
follow up PR, CC
bug-followup@freebsd.org

62. • send-pr
policy MTA
•
http://www.freebsd.org/send-pr.html
• TAB
white space white
space
• Web code
URL

66. • FreeBSD

67. • FreeBSD
•

68. • FreeBSD
•
•

69. • FreeBSD
•
•
•

70. • FreeBSD
•
•
•
•
send-pr
(
..* *)

71. ...

72. ...
•610 ( )
610 for core
•
(Y)

73. ...
•610 ( )
610 for core
•
(Y)

74. ...
•610 ( )
610 for core
•
(Y)

75. ...
~~~~( )

76. • Rabbits Party(C)

77. Questions?

78. Licensing
http://creativecommons.org/licenses/by-nc-sa/3.0/

82. Like the cool pictures?
Mostly from iStockphoto.com
Except for:
‣Silos, http://flickr.com/photos/zoomzoom/304135268/
‣Lars Trieloff,“Open Source for Tech Writing Teams”
‣ ,http://www.flickr.com/photo_zoom.gne?id=917514176size=o
Most of all was Inspirated by Stephen Collins’s “Liberate your control freaks” slide