Re: correct way to do links?
Em 17-06-2013 21:24, Dru Lavigne escreveu: 1. Links to another section within the same document. 2. Links to another book or article within the FDP. 3. Links to an external website. What is the correct usage for Docbook 4/5 for each type of link? 1. Links to another section within the same document: Is this a with the description to appear specified or an with the section automatically rendered? Yes. 2. Links to another book or article within the FDP: Is this a with the description to appear specified or an with the section automatically rendered? No. These work in a single documentation only. The best solution currently available is using with a link to the XHTML version of the document at the FreeBSD website. The drawback of this is that it hardcodes the URL into the documents. A more XML-friendly solution would be olinking but it has never been configured and used in FreeBSD's DocBook sources. It could be a longer-term target to change to that but for now, will do. 3. Should links to an external website use a tag, an url=, and the description to appear? For example: http://www.wi-fi.org/";>Wi-Fi alliance Yes. Gabor ___ freebsd-doc@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-doc To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
Re: RFC: Upgrading to DocBook 5.0
Em 17-06-2013 22:05, Dru Lavigne escreveu: Can we have a summary for the FDP (and for the benefit of Handbook editors) of when/if systemitem class= should be used? Are there also systemitems for the different types of s which should be used instead? The systemitem element is documented well here: http://www.docbook.org/tdg5/en/html/systemitem.html When to specify the class atttribute is our decision and as you see, there are different preferences. And it is important to note that at the moment we are using our extensions and will only be used once we upgrade to DB 5.0. So the documentation should not be updated with this in head but in db5. As for filename, it will be still and we already use correctly the class names, yet it should be documented. The DocBook reference is here: http://www.docbook.org/tdg5/en/html/filename.html As for the FDP, it is another item, which we have to solve. I have some ideas in my mind but I haven't got there yet so I haven't started a discussion. First, I would like to more clearly separate it into 2-3 parts: 1, A technology introduction: XML, XHTML, DocBook, XSLT. A concise introduction to the ideas behind these technologies and how they can be used for technical documentation. I think it should be like a tutorial, which includes references but it's no use trying to create another XML, XHTML or DocBook reference. It should be limited to the minimal knowledge that is necessary to get started with our docs. 2, How we use these technologies in our documentation set, i.e. the FreeBSD-specific things. One with previous knowledge in DocBook would be able to start reading here. It could fit here whether we use classes on systemitems and how our .mk files work, etc. 3, The FreeBSD writing style. General advices, spelling, etc. Gabor ___ freebsd-doc@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-doc To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
wrong: Last modified on April 2000 by . in porters handbook
http://www.freebsd.org/doc/en_US.ISO8859-1/books/porters-handbook/index.html says: Last modified on April 2000 by . Thanks Anton ___ freebsd-doc@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-doc To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
Your Website & Mobile App Requirements
Hello, Hope you are doing well! I am writing you this e-mail hoping and just to check if you have any Web or Mobile Application Development requirements. TechnoScore can help you build or turn your existing website/mobile application into a personal, accessible, and user-friendly medium that instantly connects with your audience. Reckoned among India's best web design, development and mobile apps development companies, TechnoScore has a proven track-record in providing technology consulting, cutting edge web development and outsourcing solutions to clients worldwide. We make use of superior technologies and features like CSS3, Ajax, jQuery, Flash 5, Flex, HTML5, XML, etc. We can empower you with high performance websites, mobile applications, mobile sites and responsive layouts suited for today's dynamic digital environment. Heres what we offer: OUR SERVICES - Customized iPhone/Android/Window Mobile Applications - Custom web applications including e-Commerce, Corporate and Community websites - Content Management Systems (Joomla, Drupal, Word Press etc.) - Open Source eCommerce Solutions (Magento, OSCommerce, X-Cart, ZenCart) - Web 2.0 applications - Website redesign and maintenance - Flash websites, training/elearning modules and presentations Why Choose TechnoScore? - 400+ Global Customers - 13+ Years in Business - 200+ highly skilled designers and developers - 1500+ Noteworthy Projects - 24-Hour Technical Support - Seamless communication - Competitive pricing & on-time delivery - No Hidden Charges Now, we don't expect you to believe our claims of excellence, we hope to prove our worth by completing a job for you, so that we could see how it goes and if it brings positive results for both of us. For more information about our solutions, capabilities, our portfolio or to read about our customers who are always delighted with our service, please feel free to visit our website http://www.technoscore.com, and our parent company website www.suntecindia.com. Looking forward to hearing from you soon and establishing a very long term relationship. Thanks & Regards, Manish Gaur (Business Development Executive) Suntec Web Services Pvt. Ltd. Skype: suntec.manish +919953105671 www.technoscore.com www.suntecindia.com ___ freebsd-doc@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-doc To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
Your Website & Mobile App Requirements
Hello, Hope you are doing well! I am writing you this e-mail hoping and just to check if you have any Web or Mobile Application Development requirements. TechnoScore can help you build or turn your existing website/mobile application into a personal, accessible, and user-friendly medium that instantly connects with your audience. Reckoned among India's best web design, development and mobile apps development companies, TechnoScore has a proven track-record in providing technology consulting, cutting edge web development and outsourcing solutions to clients worldwide. We make use of superior technologies and features like CSS3, Ajax, jQuery, Flash 5, Flex, HTML5, XML, etc. We can empower you with high performance websites, mobile applications, mobile sites and responsive layouts suited for today's dynamic digital environment. Heres what we offer: OUR SERVICES - Customized iPhone/Android/Window Mobile Applications - Custom web applications including e-Commerce, Corporate and Community websites - Content Management Systems (Joomla, Drupal, Word Press etc.) - Open Source eCommerce Solutions (Magento, OSCommerce, X-Cart, ZenCart) - Web 2.0 applications - Website redesign and maintenance - Flash websites, training/elearning modules and presentations Why Choose TechnoScore? - 400+ Global Customers - 13+ Years in Business - 200+ highly skilled designers and developers - 1500+ Noteworthy Projects - 24-Hour Technical Support - Seamless communication - Competitive pricing & on-time delivery - No Hidden Charges Now, we don't expect you to believe our claims of excellence, we hope to prove our worth by completing a job for you, so that we could see how it goes and if it brings positive results for both of us. For more information about our solutions, capabilities, our portfolio or to read about our customers who are always delighted with our service, please feel free to visit our website http://www.technoscore.com, and our parent company website www.suntecindia.com. Looking forward to hearing from you soon and establishing a very long term relationship. Thanks & Regards, Manish Gaur (Business Development Executive) Suntec Web Services Pvt. Ltd. Skype: suntec.manish +919953105671 www.technoscore.com www.suntecindia.com ___ freebsd-doc@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-doc To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
Re: wrong: Last modified on April 2000 by . in porters handbook
On Wed, Jun 19, 2013 at 12:59:43PM +0100, Anton Shterenlikht wrote: > http://www.freebsd.org/doc/en_US.ISO8859-1/books/porters-handbook/index.html > > says: > > Last modified on April 2000 by . > ... because is 'hardcoded'. A workaround is: % svn diff en_US.ISO8859-1/books/porters-handbook/book.xml Index: en_US.ISO8859-1/books/porters-handbook/book.xml === --- en_US.ISO8859-1/books/porters-handbook/book.xml (revision 41948) +++ en_US.ISO8859-1/books/porters-handbook/book.xml (working copy) @@ -18,7 +18,7 @@ The FreeBSD Documentation Project -April 2000 +$FreeBSD$ 2000 -- Best regards, Taras Korenko ___ freebsd-doc@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-doc To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
Your Website & Mobile App Requirements
Hello, Hope you are doing well! I am writing you this e-mail hoping and just to check if you have any Web or Mobile Application Development requirements. TechnoScore can help you build or turn your existing website/mobile application into a personal, accessible, and user-friendly medium that instantly connects with your audience. Reckoned among India's best web design, development and mobile apps development companies, TechnoScore has a proven track-record in providing technology consulting, cutting edge web development and outsourcing solutions to clients worldwide. We make use of superior technologies and features like CSS3, Ajax, jQuery, Flash 5, Flex, HTML5, XML, etc. We can empower you with high performance websites, mobile applications, mobile sites and responsive layouts suited for today's dynamic digital environment. Heres what we offer: OUR SERVICES - Customized iPhone/Android/Window Mobile Applications - Custom web applications including e-Commerce, Corporate and Community websites - Content Management Systems (Joomla, Drupal, Word Press etc.) - Open Source eCommerce Solutions (Magento, OSCommerce, X-Cart, ZenCart) - Web 2.0 applications - Website redesign and maintenance - Flash websites, training/elearning modules and presentations Why Choose TechnoScore? - 400+ Global Customers - 13+ Years in Business - 200+ highly skilled designers and developers - 1500+ Noteworthy Projects - 24-Hour Technical Support - Seamless communication - Competitive pricing & on-time delivery - No Hidden Charges Now, we don't expect you to believe our claims of excellence, we hope to prove our worth by completing a job for you, so that we could see how it goes and if it brings positive results for both of us. For more information about our solutions, capabilities, our portfolio or to read about our customers who are always delighted with our service, please feel free to visit our website http://www.technoscore.com, and our parent company website www.suntecindia.com. Looking forward to hearing from you soon and establishing a very long term relationship. Thanks & Regards, Manish Gaur (Business Development Executive) Suntec Web Services Pvt. Ltd. Skype: suntec.manish +919953105671 www.technoscore.com www.suntecindia.com ___ freebsd-doc@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-doc To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
Re: wrong: Last modified on April 2000 by . in porters handbook
On Wed, Jun 19, 2013 at 2:11 PM, Taras Korenko wrote: > On Wed, Jun 19, 2013 at 12:59:43PM +0100, Anton Shterenlikht wrote: >> http://www.freebsd.org/doc/en_US.ISO8859-1/books/porters-handbook/index.html >> >> says: >> >> Last modified on April 2000 by . >> ... > > because is 'hardcoded'. A workaround is: > > % svn diff en_US.ISO8859-1/books/porters-handbook/book.xml ... Fixed in r41954. -- Eitan Adler ___ freebsd-doc@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-doc To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
broken instructions for buildkernel
The steps in http://www.freebsd.org/doc/en/books/handbook/kernelconfig-building.html are simply broken/incomplete. This sequence goes straight from 'get the src' to 'make buildkernel'. Doing that to build 10-current on a 9.1 fresh install results in "no previous prototype for yyparse". Searching for that error string shows it has been a recurring problem; & returns comments like ::: "you must do make buildworld first" ::: If buildworld is a prereq, why isn't that in the instruction sequence? Even if it is only required once, on a fresh install it should be possible to look at the FreeBSD docs and build a custom kernel without hitting errors and having to search for hints. On a separate but related note: the instruction to 'cp GENERIC /root/kernels/MYKERNEL' seems pointless/dated/waste-of-disk-space/likely-to-result-in-confusion-over-time. Direct editing of the entirety of a copy of GENERIC makes it harder to figure out what changes were made specifically for local functions later when GENERIC might have changed in an update. In searching for Hyper-V related builds I stumbled across the mechanism of using 'include' to pull in a current GENERIC, then isolate all local changes in the system specific file. It seems like this would be a better example to be using for the main doc. Something like # FreeBSD kernel conf local customizations #edits to this file allow the GENERIC file to remain untouched # include /usr/src/sys/PLATFORM/conf/GENERIC # target kernel name ident MYKERNEL # GENERIC has debug symbols set makeoptsMODULES_OVERRIDE="" # PPS support enable options PPS_SYNC Tony ___ freebsd-doc@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-doc To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
Re: broken instructions for buildkernel
On Wed, Jun 19, 2013 at 04:51:01PM -0700, Tony Hain wrote: > The steps in > http://www.freebsd.org/doc/en/books/handbook/kernelconfig-building.html > are simply broken/incomplete. This sequence goes straight from 'get the src' > to 'make buildkernel'. Doing that to build 10-current on a 9.1 fresh install > results in "no previous prototype for yyparse". Searching for that error > string shows it has been a recurring problem; & returns comments like ::: > "you must do make buildworld first" ::: > If buildworld is a prereq, why isn't that in the instruction sequence? Even > if it is only required once, on a fresh install it should be possible to > look at the FreeBSD docs and build a custom kernel without hitting errors > and having to search for hints. The instructions for tracking a development branch cover the use case you want: http://www.freebsd.org/doc/handbook/current-stable.html What you were looking at is used for building a kernel from a source tree that is already in sync with the installed kernel/world. e.g, enabling PF/ALTQ. ___ freebsd-doc@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-doc To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
Re: broken instructions for buildkernel
On Wed, Jun 19, 2013 at 6:51 PM, Tony Hain wrote: > If buildworld is a prereq, why isn't that in the instruction sequence? Even > if it is only required once, on a fresh install it should be possible to > look at the FreeBSD docs and build a custom kernel without hitting errors > and having to search for hints. > It isn't a prereq. Those instructions have remained largely unchanged for years for a reason. You were following instructions on how to build a new kernel when in fact you were trying to upgrade FreeBSD. Use these steps and you'll get a lot farther: http://www.freebsd.org/doc/handbook/updating-upgrading.html -- Adam Vande More ___ freebsd-doc@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-doc To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
