From owner-freebsd-doc@FreeBSD.ORG Mon Jun 17 19:26:24 2013 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id 8FE6EA41 for ; Mon, 17 Jun 2013 19:26:24 +0000 (UTC) (envelope-from dru.lavigne@att.net) Received: from nm28-vm0.access.bullet.mail.sp2.yahoo.com (nm28-vm0.access.bullet.mail.sp2.yahoo.com [98.139.44.190]) by mx1.freebsd.org (Postfix) with ESMTP id 6F9651A76 for ; Mon, 17 Jun 2013 19:26:24 +0000 (UTC) Received: from [98.139.44.96] by nm28.access.bullet.mail.sp2.yahoo.com with NNFMP; 17 Jun 2013 19:24:17 -0000 Received: from [98.139.44.64] by tm1.access.bullet.mail.sp2.yahoo.com with NNFMP; 17 Jun 2013 19:24:17 -0000 Received: from [127.0.0.1] by omp1001.access.mail.sp2.yahoo.com with NNFMP; 17 Jun 2013 19:24:17 -0000 X-Yahoo-Newman-Property: ymail-3 X-Yahoo-Newman-Id: 34422.68458.bm@omp1001.access.mail.sp2.yahoo.com Received: (qmail 49082 invoked by uid 60001); 17 Jun 2013 19:24:16 -0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=att.net; s=s1024; t=1371497056; bh=BQFc7kboGr+qt+iBmHbTDVKzxgJwKga3ZLP0qSTBJ80=; h=X-YMail-OSG:Received:X-Rocket-MIMEInfo:X-Mailer:Message-ID:Date:From:Subject:To:MIME-Version:Content-Type; b=hddho2tQ8FXUIFj4MbH914JiRGwn974tjfwDCj9/CrkwxhxxafsvoKylaDLqn//SxlbOjZanMHTYERWlxpesttbKv/7uV9NAxjIfCfWSTi68IB1GI1ynOB4Olp8Jcap9dzTEiRlj9s1FpTrOdVxX0eyo6lfuoUJJ9oiRexX/f8o= DomainKey-Signature: a=rsa-sha1; q=dns; c=nofws; s=s1024; d=att.net; h=X-YMail-OSG:Received:X-Rocket-MIMEInfo:X-Mailer:Message-ID:Date:From:Subject:To:MIME-Version:Content-Type; b=jh1K1JQ728sE8rdDMAWWxPOXgIdEe+/Tsebd4ZYJQpYVLsRhWF53w5HZ0x5fMO74xPohEHElQH3ernSsJXeATuVQdcGa7Nba2z+uwj7nOGsJVXFahF2xDexsO6Kq/ekrC1HE5Pvn50yKVAdOI8vcHnCgWSnFnzL/TvnqL7FzfAU=; X-YMail-OSG: 85U8R6AVM1koZJApQNtBCwLP65ETDIyvRQyXvxtRaDzhmAZ 8NQTgLeEP9bf5BeYG5G._5qDGQJrwniy8TVBl_zEu39XaDLCyazyw5lVFhIb BSE8IkexYvcoePZSGyzTqejGBSheW3wHTW7QiTF9rtKWOAFgYo2_P9pa3J0i BLBhOmx.VtzCAd6WITJ9y2WBR7dwN3BJWOtEBCw0sp64pg8GcR9CACL.Pfxt hP0tKRLzRnNLq0RlaYXVqrqygVKY26Rv3wOY1BQ5E8BF1k7Oa07IuYoo6wLX 2.wfnoGUEsWMvR5WwzPPn2V8gbnU7sAbUVSRibuuxS9J3e6JStqrYQuNp5I4 mF1AiqKRHKmEPyuNNiRoL_Z61ZkJm4o.3NlWR3OA6hlj09Yi7e3p7fFVATKX 4HdU2D3DnfYFChl_bHtuUT_1acVtH9rCS_DkpfBUSlrDEO_6lH6ZH3BXzEXS KqdovGtgXWKB9M9MwFBzrEDgW5mh6JbOA.jc0TiIUQO.q.xam1uK5zSxEiv_ .C4Cb6_7ZEwmLJAOdsPfGWcy3wCJQvLkval7N8sCNSi.w0mplD.X78ReUyMM kG.i_Ga2SH88EIizeO5OJpbph6WoOG2ohxW.q1hI28v.zuj_B9kB2RZZ1JKd BnByN5M0FkNqEffHGa.93qUy1oqNHSWAQ8QxX2NFecg7PtTHn4i2LDm8- Received: from [98.100.91.226] by web184902.mail.gq1.yahoo.com via HTTP; Mon, 17 Jun 2013 12:24:16 PDT X-Rocket-MIMEInfo: 002.001, SSdtIHVwZGF0aW5nIGh0dHA6Ly93d3cuZnJlZWJzZC5vcmcvZG9jL2VuX1VTLklTTzg4NTktMS9ib29rcy9mZHAtcHJpbWVyL3htbC1tYXJrdXAtZG9jYm9vay5odG1sLCBzZWN0aW9uICI0LjIuNyBMaW5rcyIgdG8gbWFrZSBzdXJlIGhvdyB0byBkbyB0aGVzZSAzIHR5cGVzIG9mIGxpbmtzIGlzIGNyeXN0YWwgY2xlYXI6CgoxLiBMaW5rcyB0byBhbm90aGVyIHNlY3Rpb24gd2l0aGluIHRoZSBzYW1lIGRvY3VtZW50LgoKMi4gTGlua3MgdG8gYW5vdGhlciBib29rIG9yIGFydGljbGUgd2l0aGluIHRoZSBGRFABMAEBAQE- X-Mailer: YahooMailClassic/16.0.3 YahooMailWebService/0.8.147.553 Message-ID: <1371497056.46380.YahooMailClassic@web184902.mail.gq1.yahoo.com> Date: Mon, 17 Jun 2013 12:24:16 -0700 (PDT) From: Dru Lavigne Subject: correct way to do links? To: freebsd-doc@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 17 Jun 2013 19:26:24 -0000 I'm updating http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/xml-markup-docbook.html, section "4.2.7 Links" to make sure how to do these 3 types of links is crystal clear: 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? 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? 3. Should links to an external website use a tag, an url=, and the description to appear? For example: Wi-Fi alliance Cheers, Dru