Re: local copy of handbook
Daniel Gerzo wrote: Hello Jerry, For more information see http://docsnap.sk.freebsd.org/ and possibly the rsync manual page. I was having a problem reaching that URL; however, I found that this one: http://www.oook.cz/bsd/docsnap.html did seem to work. In any case, I am unable to get the 'rsync' command to work. This is the output of one such attempt. ~ $ sudo rsync -rltvz docsnap.sk.FreeBSD.org::docsnap /usr/share/doc/ rsync: failed to connect to docsnap.sk.FreeBSD.org: Operation timed out (60) rsync error: error in socket IO (code 10) at clientserver.c(124) [receiver=3.0.5] This has happened continually for the past few days. I am not sure if it is a temporary problem or or permanent one. The docsnap.sk.FreeBSD.org (as well as ftp.sk and cvsup.sk) server is currently offline due to some problems after its update. Unfortunately it's been a vacations period here and we were unable to get personally to the box and fix it. However I have been told that the issue should be resolved tommorrow, so I would recommend you to try tommorrow or a bit later. I tried to update my doc with DocSnap but it seems the is no docsnap rsync module in the server. flumen# rsync -rltvz docsnap.sk.FreeBSD.org::docsnap /usr/share/doc rsync: failed to connect to docsnap.sk.FreeBSD.org: Connection refused (61) rsync error: error in socket IO (code 10) at clientserver.c(124) [receiver=3.0.5] flumen# ping docsnap.sk.FreeBSD.org PING sk.FreeBSD.org (81.89.56.57): 56 data bytes 64 bytes from 81.89.56.57: icmp_seq=0 ttl=243 time=67.247 ms 64 bytes from 81.89.56.57: icmp_seq=1 ttl=243 time=68.471 ms 64 bytes from 81.89.56.57: icmp_seq=2 ttl=243 time=68.076 ms 64 bytes from 81.89.56.57: icmp_seq=3 ttl=243 time=72.538 ms 64 bytes from 81.89.56.57: icmp_seq=4 ttl=243 time=67.705 ms ^C --- sk.FreeBSD.org ping statistics --- 5 packets transmitted, 5 packets received, 0.0% packet loss round-trip min/avg/max/stddev = 67.247/68.807/72.538/1.909 ms flumen# rsync docsnap.sk.FreeBSD.org rsync: link_stat /usr/ports/net/rsync/docsnap.sk.FreeBSD.org failed: No such file or directory (2) rsync error: some files/attrs were not transferred (see previous errors) (code 23) at main.c(1040) [sender=3.0.5] Any news regarding the server's availability? ___ freebsd-questions@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-questions To unsubscribe, send any mail to freebsd-questions-unsubscr...@freebsd.org
Re: local copy of handbook
On Mon, 29 Dec 2008 10:59:04 -0500 Randy Pratt bsd-u...@embarqmail.com wrote: You might consider using Docsnap. This allows you to maintain all the FreeBSD documentation with a minimum of effort. Docsnap is an rsync repository for easy updating of installed FreeBSD documentation (/usr/share/doc). The first run may take longer but subsequent updates take very little time. Only the differences in the documents are transferred. That is the main advantage but you also do not need to install ports with hefty overhead to build documents. Rsync is only utility required (/usr/ports/net/rsync). Typical usage: # rsync -rltvz docsnap.sk.FreeBSD.org::docsnap /usr/share/doc/ For more information see http://docsnap.sk.freebsd.org/ and possibly the rsync manual page. I reported last week that this was not working. It still fails with the following error message: ~ # rsync -rltvz docsnap.sk.FreeBSD.org::docsnap /usr/share/doc/ rsync: failed to connect to docsnap.sk.FreeBSD.org: Connection refused (61) rsync error: error in socket IO (code 10) at clientserver.c(124) [receiver=3.0.5] I was under the impression that someone was looking into it. Is there any estimated time for the link to be fixed? -- Jerry ges...@yahoo.com Strategy: A long-range plan whose merit cannot be evaluated until sometime after those creating it have left the organization. signature.asc Description: PGP signature
Re[2]: local copy of handbook
Hello Jerry, For more information see http://docsnap.sk.freebsd.org/ and possibly the rsync manual page. I was having a problem reaching that URL; however, I found that this one: http://www.oook.cz/bsd/docsnap.html did seem to work. In any case, I am unable to get the 'rsync' command to work. This is the output of one such attempt. ~ $ sudo rsync -rltvz docsnap.sk.FreeBSD.org::docsnap /usr/share/doc/ rsync: failed to connect to docsnap.sk.FreeBSD.org: Operation timed out (60) rsync error: error in socket IO (code 10) at clientserver.c(124) [receiver=3.0.5] This has happened continually for the past few days. I am not sure if it is a temporary problem or or permanent one. The docsnap.sk.FreeBSD.org (as well as ftp.sk and cvsup.sk) server is currently offline due to some problems after its update. Unfortunately it's been a vacations period here and we were unable to get personally to the box and fix it. However I have been told that the issue should be resolved tommorrow, so I would recommend you to try tommorrow or a bit later. -- Best regards, Danielmailto:dan...@freebsd.org ___ freebsd-questions@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-questions To unsubscribe, send any mail to freebsd-questions-unsubscr...@freebsd.org
Re: local copy of handbook
On Sun, 4 Jan 2009 18:28:46 +0100 Daniel Gerzo dan...@freebsd.org wrote: The docsnap.sk.FreeBSD.org (as well as ftp.sk and cvsup.sk) server is currently offline due to some problems after its update. Unfortunately it's been a vacations period here and we were unable to get personally to the box and fix it. However I have been told that the issue should be resolved tommorrow, so I would recommend you to try tommorrow or a bit later. Thanks for the info. -- Jerry ges...@yahoo.com Let's love each other slowly, reaching for a plane, of exquisite pleasure, and delicate pain. Adam Beslove signature.asc Description: PGP signature
Re: local copy of handbook
On Mon, 29 Dec 2008 10:59:04 -0500 Randy Pratt bsd-u...@embarqmail.com wrote: On Mon, 29 Dec 2008 20:39:42 +0530 Masoom Shaikh masoom.sha...@gmail.com wrote: On Monday 29 December 2008 18:15:58 RW wrote: On Mon, 29 Dec 2008 10:16:42 +0530 Masoom Shaikh masoom.sha...@gmail.com wrote: lso I cud use tarballs from FTP, but is there easy way to install them ? also csup didn't help here is my csup file *default tag=RELENG_7 *default host=ftp2.tw.freebsd.org *default prefix=/usr *default base=/var/db *default release=cvs delete use-rel-suffix compress src-all doc-all csup updates the source each time, but now i am not sure about doc!! If you do it that way, you have to generate the html files yourself, cvup fetches generic data files that can be used to generate html , pdf etc. What I do these days is mirror the online version with wget. #!/bin/sh cd /usr/share/doc/en wg_args= --mirror -np -nH --cut-dirs=2 --limit-rate=33k bg_flags= # Run quietly from cron [ ! -t 0 ] bg_flags= --quiet wget $bg_flags $wg_args http://www.freebsd.org/doc/en_US.ISO8859-1/; ___ freebsd-questions@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-questions To unsubscribe, send any mail to freebsd-questions-unsubscr...@freebsd.org that is clever use of wget :) but can't docs remain updated with csup ? if yes, how ? otherwise I will be happy to generate them from sources if they happen to be some simple target You might consider using Docsnap. This allows you to maintain all the FreeBSD documentation with a minimum of effort. Docsnap is an rsync repository for easy updating of installed FreeBSD documentation (/usr/share/doc). The first run may take longer but subsequent updates take very little time. Only the differences in the documents are transferred. That is the main advantage but you also do not need to install ports with hefty overhead to build documents. Rsync is only utility required (/usr/ports/net/rsync). Typical usage: # rsync -rltvz docsnap.sk.FreeBSD.org::docsnap /usr/share/doc/ For more information see http://docsnap.sk.freebsd.org/ and possibly the rsync manual page. I was having a problem reaching that URL; however, I found that this one: http://www.oook.cz/bsd/docsnap.html did seem to work. In any case, I am unable to get the 'rsync' command to work. This is the output of one such attempt. ~ $ sudo rsync -rltvz docsnap.sk.FreeBSD.org::docsnap /usr/share/doc/ rsync: failed to connect to docsnap.sk.FreeBSD.org: Operation timed out (60) rsync error: error in socket IO (code 10) at clientserver.c(124) [receiver=3.0.5] This has happened continually for the past few days. I am not sure if it is a temporary problem or or permanent one. -- Jerry ges...@yahoo.com A crow perched himself on a telephone wire. He was going to make a long-distance caw. signature.asc Description: PGP signature
Re: local copy of handbook
On Thu, 1 Jan 2009 09:27:31 +0530, Masoom Shaikh masoom.sha...@gmail.com wrote: On Tue, Dec 30, 2008 at 9:19 PM, Giorgos Keramidas keram...@ceid.upatras.gr wrote: I'd be happy to review the patch that Gabor has written if necessary add or subtract from it. It will take me a bit of time to get up to speed with the mark-up review/grok the updating docs in the round. ATM, they certainly fall short of including anything about updating a local copy of the docs. I can build a patched Handbook and upload it online, if that helps. Then you don't have to learn SGML to read it. Just let me know if you need it, and it's done. wow, am waiting eagerlyHTML is complex, what is SGML :) You don't really have to read the HTML _source_. Point your browser to: http://people.freebsd.org/~keramida/doc/en_US.ISO8859-1/books/handbook/updating-upgrading-documentation.html I have uploaded a patched Handbook there. The latest version of the SGML patch that I have here is also online now, at: http://people.freebsd.org/~keramida/doc-patches/pgj.doc-update.20081227-2338.diff ___ freebsd-questions@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-questions To unsubscribe, send any mail to freebsd-questions-unsubscr...@freebsd.org
Re: local copy of handbook
On Thu, Jan 01, 2009 at 09:27:31AM +0530, Masoom Shaikh wrote: snip wow, am waiting eagerlyHTML is complex, what is SGML :) The fdp primer introduces it: http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/index.html All the docs are written it, from which the html, postscript etc. are generated. Regards, -- Frank Contact info: http://www.shute.org.uk/misc/contact.html ___ freebsd-questions@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-questions To unsubscribe, send any mail to freebsd-questions-unsubscr...@freebsd.org
Re: local copy of handbook
On Thu, Jan 1, 2009 at 10:17 PM, Frank Shute fr...@shute.org.uk wrote: On Thu, Jan 01, 2009 at 09:27:31AM +0530, Masoom Shaikh wrote: snip wow, am waiting eagerlyHTML is complex, what is SGML :) The fdp primer introduces it: http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/index.html All the docs are written it, from which the html, postscript etc. are generated. Regards, -- Frank Contact info: http://www.shute.org.uk/misc/contact.html thank you Frank, but that was a joke :) ___ freebsd-questions@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-questions To unsubscribe, send any mail to freebsd-questions-unsubscr...@freebsd.org
Re: local copy of handbook
Masoom Shaikh wrote: [snip] wow, am waiting eagerlyHTML is complex, what is SGML :) Stands for Standard Generalized Markup Language, with roots in the printing industry. When authors submit a manuscript for publishing it contains content, but it is up to the typesetter how it will appear on the page when printed. The layout and columns in a printed magazine or newspaper are examples of this. HTML and XML are actually subsets of SGML, with SGML being a meta markup language. The primary advantage of authoring documentation using SGML is that it is relatively easy to parse and convert into many different formats from one source document. This way you maintain one document, and then regenerate the copies, e.g. HTML, XHTML, XML, etc, on an as needed basis. Plenty of more info is readily available on the Web. -Mike ___ freebsd-questions@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-questions To unsubscribe, send any mail to freebsd-questions-unsubscr...@freebsd.org
Re: local copy of handbook
On Tue, Dec 30, 2008 at 7:03 PM, Frank Shute fr...@shute.org.uk wrote: On Mon, Dec 29, 2008 at 11:52:57PM +0200, Giorgos Keramidas wrote: On Mon, 29 Dec 2008 20:27:17 +, Frank Shute fr...@shute.org.uk wrote: You can keep a local copy of the docs update the sources for the docs with csup but you have to regenerate them with a make command after you have csup'd. The process is described within this page I just put up: http://www.shute.org.uk/misc/freebsd_uptodate.html Hi Masoom, We have been working on a patch for the Handbook that adds a short description of the same process. The patch has been recently posted to freebsd-doc, by Gabor Pali: http://lists.freebsd.org/pipermail/freebsd-doc/2008-December/015315.html Since you already have written something similar, do you think we can convince you to review the patch? It would be nice if you could help us improve it or make it easier to read, and use. Hi Giorgos, I think your post was meant to be addressed to me as I wrote the above guide. even I was confused :). Damn, i have never contributed a line to FreeBSD :( am a professional C/C++ programmer on windoz with minimal expertise in using patch, binutils etc, FreeBSD is just my hobby @ home. I will contribute some day, amen thanks to guys like Frank, appreciate their work I'd be happy to review the patch that Gabor has written if necessary add or subtract from it. It will take me a bit of time to get up to speed with the mark-up review/grok the updating docs in the round. ATM, they certainly fall short of including anything about updating a local copy of the docs. I'll sign up for docs@ then my impertinent/stupid questions about the docs can be answered therehopefully ;) Regards, -- Frank Contact info: http://www.shute.org.uk/misc/contact.html ___ freebsd-questions@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-questions To unsubscribe, send any mail to freebsd-questions-unsubscr...@freebsd.org ___ freebsd-questions@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-questions To unsubscribe, send any mail to freebsd-questions-unsubscr...@freebsd.org
Re: local copy of handbook
On Tue, Dec 30, 2008 at 9:19 PM, Giorgos Keramidas keram...@ceid.upatras.gr wrote: On Tue, 30 Dec 2008 13:33:45 +, Frank Shute fr...@shute.org.uk wrote: On Mon, Dec 29, 2008 at 11:52:57PM +0200, Giorgos Keramidas wrote: On Mon, 29 Dec 2008 20:27:17 +, Frank Shute fr...@shute.org.uk wrote: You can keep a local copy of the docs update the sources for the docs with csup but you have to regenerate them with a make command after you have csup'd. The process is described within this page I just put up: http://www.shute.org.uk/misc/freebsd_uptodate.html Hi Masoom, We have been working on a patch for the Handbook that adds a short description of the same process. The patch has been recently posted to freebsd-doc, by Gabor Pali: http://lists.freebsd.org/pipermail/freebsd-doc/2008-December/015315.html Since you already have written something similar, do you think we can convince you to review the patch? It would be nice if you could help us improve it or make it easier to read, and use. Hi Giorgos, I think your post was meant to be addressed to me as I wrote the above guide. Yes. Sorry about that Frank :) I'd be happy to review the patch that Gabor has written if necessary add or subtract from it. It will take me a bit of time to get up to speed with the mark-up review/grok the updating docs in the round. ATM, they certainly fall short of including anything about updating a local copy of the docs. I can build a patched Handbook and upload it online, if that helps. Then you don't have to learn SGML to read it. Just let me know if you need it, and it's done. wow, am waiting eagerlyHTML is complex, what is SGML :) ___ freebsd-questions@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-questions To unsubscribe, send any mail to freebsd-questions-unsubscr...@freebsd.org ___ freebsd-questions@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-questions To unsubscribe, send any mail to freebsd-questions-unsubscr...@freebsd.org
Re: local copy of handbook
On Mon, Dec 29, 2008 at 11:52:57PM +0200, Giorgos Keramidas wrote: On Mon, 29 Dec 2008 20:27:17 +, Frank Shute fr...@shute.org.uk wrote: You can keep a local copy of the docs update the sources for the docs with csup but you have to regenerate them with a make command after you have csup'd. The process is described within this page I just put up: http://www.shute.org.uk/misc/freebsd_uptodate.html Hi Masoom, We have been working on a patch for the Handbook that adds a short description of the same process. The patch has been recently posted to freebsd-doc, by Gabor Pali: http://lists.freebsd.org/pipermail/freebsd-doc/2008-December/015315.html Since you already have written something similar, do you think we can convince you to review the patch? It would be nice if you could help us improve it or make it easier to read, and use. Hi Giorgos, I think your post was meant to be addressed to me as I wrote the above guide. I'd be happy to review the patch that Gabor has written if necessary add or subtract from it. It will take me a bit of time to get up to speed with the mark-up review/grok the updating docs in the round. ATM, they certainly fall short of including anything about updating a local copy of the docs. I'll sign up for docs@ then my impertinent/stupid questions about the docs can be answered therehopefully ;) Regards, -- Frank Contact info: http://www.shute.org.uk/misc/contact.html ___ freebsd-questions@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-questions To unsubscribe, send any mail to freebsd-questions-unsubscr...@freebsd.org
Re: local copy of handbook
On Tue, 30 Dec 2008 13:33:45 +, Frank Shute fr...@shute.org.uk wrote: On Mon, Dec 29, 2008 at 11:52:57PM +0200, Giorgos Keramidas wrote: On Mon, 29 Dec 2008 20:27:17 +, Frank Shute fr...@shute.org.uk wrote: You can keep a local copy of the docs update the sources for the docs with csup but you have to regenerate them with a make command after you have csup'd. The process is described within this page I just put up: http://www.shute.org.uk/misc/freebsd_uptodate.html Hi Masoom, We have been working on a patch for the Handbook that adds a short description of the same process. The patch has been recently posted to freebsd-doc, by Gabor Pali: http://lists.freebsd.org/pipermail/freebsd-doc/2008-December/015315.html Since you already have written something similar, do you think we can convince you to review the patch? It would be nice if you could help us improve it or make it easier to read, and use. Hi Giorgos, I think your post was meant to be addressed to me as I wrote the above guide. Yes. Sorry about that Frank :) I'd be happy to review the patch that Gabor has written if necessary add or subtract from it. It will take me a bit of time to get up to speed with the mark-up review/grok the updating docs in the round. ATM, they certainly fall short of including anything about updating a local copy of the docs. I can build a patched Handbook and upload it online, if that helps. Then you don't have to learn SGML to read it. Just let me know if you need it, and it's done. ___ freebsd-questions@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-questions To unsubscribe, send any mail to freebsd-questions-unsubscr...@freebsd.org
Re: local copy of handbook
On Mon, 29 Dec 2008 10:16:42 +0530 Masoom Shaikh masoom.sha...@gmail.com wrote: lso I cud use tarballs from FTP, but is there easy way to install them ? also csup didn't help here is my csup file *default tag=RELENG_7 *default host=ftp2.tw.freebsd.org *default prefix=/usr *default base=/var/db *default release=cvs delete use-rel-suffix compress src-all doc-all csup updates the source each time, but now i am not sure about doc!! If you do it that way, you have to generate the html files yourself, cvup fetches generic data files that can be used to generate html , pdf etc. What I do these days is mirror the online version with wget. #!/bin/sh cd /usr/share/doc/en wg_args= --mirror -np -nH --cut-dirs=2 --limit-rate=33k bg_flags= # Run quietly from cron [ ! -t 0 ] bg_flags= --quiet wget $bg_flags $wg_args http://www.freebsd.org/doc/en_US.ISO8859-1/; ___ freebsd-questions@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-questions To unsubscribe, send any mail to freebsd-questions-unsubscr...@freebsd.org
Re: local copy of handbook
On Monday 29 December 2008 18:15:58 RW wrote: On Mon, 29 Dec 2008 10:16:42 +0530 Masoom Shaikh masoom.sha...@gmail.com wrote: lso I cud use tarballs from FTP, but is there easy way to install them ? also csup didn't help here is my csup file *default tag=RELENG_7 *default host=ftp2.tw.freebsd.org *default prefix=/usr *default base=/var/db *default release=cvs delete use-rel-suffix compress src-all doc-all csup updates the source each time, but now i am not sure about doc!! If you do it that way, you have to generate the html files yourself, cvup fetches generic data files that can be used to generate html , pdf etc. What I do these days is mirror the online version with wget. #!/bin/sh cd /usr/share/doc/en wg_args= --mirror -np -nH --cut-dirs=2 --limit-rate=33k bg_flags= # Run quietly from cron [ ! -t 0 ] bg_flags= --quiet wget $bg_flags $wg_args http://www.freebsd.org/doc/en_US.ISO8859-1/; ___ freebsd-questions@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-questions To unsubscribe, send any mail to freebsd-questions-unsubscr...@freebsd.org that is clever use of wget :) but can't docs remain updated with csup ? if yes, how ? otherwise I will be happy to generate them from sources if they happen to be some simple target Masoom Shaikh ___ freebsd-questions@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-questions To unsubscribe, send any mail to freebsd-questions-unsubscr...@freebsd.org
Re: local copy of handbook
On Mon, 29 Dec 2008 20:39:42 +0530 Masoom Shaikh masoom.sha...@gmail.com wrote: On Monday 29 December 2008 18:15:58 RW wrote: On Mon, 29 Dec 2008 10:16:42 +0530 Masoom Shaikh masoom.sha...@gmail.com wrote: lso I cud use tarballs from FTP, but is there easy way to install them ? also csup didn't help here is my csup file *default tag=RELENG_7 *default host=ftp2.tw.freebsd.org *default prefix=/usr *default base=/var/db *default release=cvs delete use-rel-suffix compress src-all doc-all csup updates the source each time, but now i am not sure about doc!! If you do it that way, you have to generate the html files yourself, cvup fetches generic data files that can be used to generate html , pdf etc. What I do these days is mirror the online version with wget. #!/bin/sh cd /usr/share/doc/en wg_args= --mirror -np -nH --cut-dirs=2 --limit-rate=33k bg_flags= # Run quietly from cron [ ! -t 0 ] bg_flags= --quiet wget $bg_flags $wg_args http://www.freebsd.org/doc/en_US.ISO8859-1/; ___ freebsd-questions@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-questions To unsubscribe, send any mail to freebsd-questions-unsubscr...@freebsd.org that is clever use of wget :) but can't docs remain updated with csup ? if yes, how ? otherwise I will be happy to generate them from sources if they happen to be some simple target You might consider using Docsnap. This allows you to maintain all the FreeBSD documentation with a minimum of effort. Docsnap is an rsync repository for easy updating of installed FreeBSD documentation (/usr/share/doc). The first run may take longer but subsequent updates take very little time. Only the differences in the documents are transferred. That is the main advantage but you also do not need to install ports with hefty overhead to build documents. Rsync is only utility required (/usr/ports/net/rsync). Typical usage: # rsync -rltvz docsnap.sk.FreeBSD.org::docsnap /usr/share/doc/ For more information see http://docsnap.sk.freebsd.org/ and possibly the rsync manual page. HTH, Randy -- ___ freebsd-questions@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-questions To unsubscribe, send any mail to freebsd-questions-unsubscr...@freebsd.org
Re: local copy of handbook
On Mon, Dec 29, 2008 at 08:39:42PM +0530, Masoom Shaikh wrote: On Monday 29 December 2008 18:15:58 RW wrote: On Mon, 29 Dec 2008 10:16:42 +0530 Masoom Shaikh masoom.sha...@gmail.com wrote: lso I cud use tarballs from FTP, but is there easy way to install them ? also csup didn't help here is my csup file *default tag=RELENG_7 *default host=ftp2.tw.freebsd.org *default prefix=/usr *default base=/var/db *default release=cvs delete use-rel-suffix compress src-all doc-all csup updates the source each time, but now i am not sure about doc!! If you do it that way, you have to generate the html files yourself, cvup fetches generic data files that can be used to generate html , pdf etc. What I do these days is mirror the online version with wget. #!/bin/sh cd /usr/share/doc/en wg_args= --mirror -np -nH --cut-dirs=2 --limit-rate=33k bg_flags= # Run quietly from cron [ ! -t 0 ] bg_flags= --quiet wget $bg_flags $wg_args http://www.freebsd.org/doc/en_US.ISO8859-1/; that is clever use of wget :) but can't docs remain updated with csup ? if yes, how ? otherwise I will be happy to generate them from sources if they happen to be some simple target You can keep a local copy of the docs update the sources for the docs with csup but you have to regenerate them with a make command after you have csup'd. The process is described within this page I just put up: http://www.shute.org.uk/misc/freebsd_uptodate.html There maybe some errors there or things I've missed, so apologies for that in advance. Any questions, just drop me an email. It's good practice IMO to have a locally updated copy of the handbook. You always need the handbook when your 'net connection is down ;) Regards, -- Frank Contact info: http://www.shute.org.uk/misc/contact.html ___ freebsd-questions@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-questions To unsubscribe, send any mail to freebsd-questions-unsubscr...@freebsd.org
Re: local copy of handbook
On Mon, 29 Dec 2008 20:27:17 + Frank Shute fr...@shute.org.uk wrote: You can keep a local copy of the docs update the sources for the docs with csup but you have to regenerate them with a make command after you have csup'd. The process is described within this page I just put up: http://www.shute.org.uk/misc/freebsd_uptodate.html There maybe some errors there or things I've missed, so apologies for that in advance. Any questions, just drop me an email. It's good practice IMO to have a locally updated copy of the handbook. You always need the handbook when your 'net connection is down ;) Are the docs branched? I tried running a csup with tag=RELENG_7 and nothing got created; changing the line doc-all to doc-all tag=. fixed it and fetched all the docs. -- Bruce Cran ___ freebsd-questions@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-questions To unsubscribe, send any mail to freebsd-questions-unsubscr...@freebsd.org
Re: local copy of handbook
On Mon, 29 Dec 2008 20:27:17 +, Frank Shute fr...@shute.org.uk wrote: You can keep a local copy of the docs update the sources for the docs with csup but you have to regenerate them with a make command after you have csup'd. The process is described within this page I just put up: http://www.shute.org.uk/misc/freebsd_uptodate.html Hi Masoom, We have been working on a patch for the Handbook that adds a short description of the same process. The patch has been recently posted to freebsd-doc, by Gabor Pali: http://lists.freebsd.org/pipermail/freebsd-doc/2008-December/015315.html Since you already have written something similar, do you think we can convince you to review the patch? It would be nice if you could help us improve it or make it easier to read, and use. Regards, Giorgos pgpSoMDRDFWeo.pgp Description: PGP signature
Re: local copy of handbook
On Mon, 29 Dec 2008 21:43:19 +, Bruce Cran br...@cran.org.uk wrote: Are the docs branched? I tried running a csup with tag=RELENG_7 and nothing got created; changing the line doc-all to doc-all tag=. fixed it and fetched all the docs. Hi Bruce, No, there are no release-specific branches to the doc/ tree. The 'HEAD' of the CVS repository is all there is. If you look at the CVS tag names, there _are_ a few old branches and experimental tags, but these are mostly left-overs from projects that are no longer active. The tag=. run that you used should give you the latest documentation sources :-) ___ freebsd-questions@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-questions To unsubscribe, send any mail to freebsd-questions-unsubscr...@freebsd.org
Re: local copy of handbook
On Mon, Dec 29, 2008 at 09:43:19PM +, Bruce Cran wrote: On Mon, 29 Dec 2008 20:27:17 + Frank Shute fr...@shute.org.uk wrote: You can keep a local copy of the docs update the sources for the docs with csup but you have to regenerate them with a make command after you have csup'd. The process is described within this page I just put up: http://www.shute.org.uk/misc/freebsd_uptodate.html There maybe some errors there or things I've missed, so apologies for that in advance. Any questions, just drop me an email. It's good practice IMO to have a locally updated copy of the handbook. You always need the handbook when your 'net connection is down ;) Are the docs branched? I tried running a csup with tag=RELENG_7 and nothing got created; changing the line doc-all to doc-all tag=. fixed it and fetched all the docs. Hi Bruce, As Giorgios points out, the docs aren't branched. I'll try make it clearer on that page that it's only for SUPFILE(source) that there is a branch you have to follow. PORTSSUPFILE(ports) DOCSUPFILE(docs) are just given the current tag, which they should have by default. Regards, -- Frank Contact info: http://www.shute.org.uk/misc/contact.html ___ freebsd-questions@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-questions To unsubscribe, send any mail to freebsd-questions-unsubscr...@freebsd.org
Re: local copy of handbook
On Tue, 30 Dec 2008 06:12:51 + Frank Shute fr...@shute.org.uk wrote: As Giorgios points out, the docs aren't branched. I'll try make it clearer on that page that it's only for SUPFILE(source) that there is a branch you have to follow. PORTSSUPFILE(ports) DOCSUPFILE(docs) are just given the current tag, which they should have by default. Sorry I missed where you say to use the doc-supfile; I thought both src and doc were being fetched using a single cvsupfile like in Masoom's original email. On reading the page again it's actually quite clear that you should use the standard doc-supfile which will contain the correct tag line. -- Bruce Cran ___ freebsd-questions@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-questions To unsubscribe, send any mail to freebsd-questions-unsubscr...@freebsd.org
local copy of handbook
hello list, in my previous FBSD installations i always had a local copy of handbook never bothered how it got there, until now. i lost my installation due to some good ups. reinstalled minimal 7.0 and build installed kernel world uname -a FreeBSD raptor 7.1-PRERELEASE FreeBSD 7.1-PRERELEASE #0: Wed Dec 17 13:27:42 UTC 2008 root@:/usr/obj/usr/src/sys/ARGON18 amd64 now i cannot see local copy of handbook, i had look at FreeBSD Documentation Primer but that seems overkill and geared towards contributing documentation http://www.freebsd.org/doc/en/books/fdp-primer/ also I cud use tarballs from FTP, but is there easy way to install them ? also csup didn't help here is my csup file *default tag=RELENG_7 *default host=ftp2.tw.freebsd.org *default prefix=/usr *default base=/var/db *default release=cvs delete use-rel-suffix compress src-all doc-all csup updates the source each time, but now i am not sure about doc!! hints and help ? Masoom Shaikh ___ freebsd-questions@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-questions To unsubscribe, send any mail to freebsd-questions-unsubscr...@freebsd.org
Re: local copy of handbook
Masoom Shaikh wrote: hello list, in my previous FBSD installations i always had a local copy of handbook never bothered how it got there, until now. i lost my installation due to some good ups. reinstalled minimal 7.0 and build installed kernel world uname -a FreeBSD raptor 7.1-PRERELEASE FreeBSD 7.1-PRERELEASE #0: Wed Dec 17 13:27:42 UTC 2008 root@:/usr/obj/usr/src/sys/ARGON18 amd64 now i cannot see local copy of handbook, i had look at FreeBSD Documentation Primer but that seems overkill and geared towards contributing documentation http://www.freebsd.org/doc/en/books/fdp-primer/ also I cud use tarballs from FTP, but is there easy way to install them ? also csup didn't help here is my csup file *default tag=RELENG_7 *default host=ftp2.tw.freebsd.org *default prefix=/usr *default base=/var/db *default release=cvs delete use-rel-suffix compress src-all doc-all csup updates the source each time, but now i am not sure about doc!! hints and help ? Masoom Shaikh Minimal install does not include the handbook. Thats why its called a minimal install. Normal install you get handbook. The following link to the handbook's first page tell you where to ftp your copy from. http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/index.html ___ freebsd-questions@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-questions To unsubscribe, send any mail to freebsd-questions-unsubscr...@freebsd.org ___ freebsd-questions@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-questions To unsubscribe, send any mail to freebsd-questions-unsubscr...@freebsd.org
Re: local copy of handbook
On Monday 29 December 2008 2:46:42 am Masoom Shaikh wrote: hello list, in my previous FBSD installations i always had a local copy of handbook never bothered how it got there, until now. i lost my installation due to some good ups. reinstalled minimal 7.0 and build installed kernel world uname -a FreeBSD raptor 7.1-PRERELEASE FreeBSD 7.1-PRERELEASE #0: Wed Dec 17 13:27:42 UTC 2008 root@:/usr/obj/usr/src/sys/ARGON18 amd64 now i cannot see local copy of handbook, i had look at FreeBSD Documentation Primer but that seems overkill and geared towards contributing documentation http://www.freebsd.org/doc/en/books/fdp-primer/ also I cud use tarballs from FTP, but is there easy way to install them ? also csup didn't help here is my csup file *default tag=RELENG_7 *default host=ftp2.tw.freebsd.org *default prefix=/usr *default base=/var/db *default release=cvs delete use-rel-suffix compress src-all doc-all csup updates the source each time, but now i am not sure about doc!! hints and help ? Masoom Shaikh ___ freebsd-questions@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-questions To unsubscribe, send any mail to freebsd-questions-unsubscr...@freebsd.org sysinstall - Configure - Distributions - docs ? Have fun :) -- Blessings Gonzalo Nemmi ___ freebsd-questions@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-questions To unsubscribe, send any mail to freebsd-questions-unsubscr...@freebsd.org