From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Kelly Dean Newsgroups: gmane.emacs.devel Subject: Re: Correspondence between web-pages and Info-pages Date: Sat, 03 Jan 2015 08:14:35 +0000 Message-ID: References: NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1420272955 29371 80.91.229.3 (3 Jan 2015 08:15:55 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 3 Jan 2015 08:15:55 +0000 (UTC) Cc: emacs-devel@gnu.org To: Richard Stallman Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Jan 03 09:15:49 2015 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1Y7JsC-0006Sx-Uk for ged-emacs-devel@m.gmane.org; Sat, 03 Jan 2015 09:15:49 +0100 Original-Received: from localhost ([::1]:53719 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Y7JsB-0003lN-Su for ged-emacs-devel@m.gmane.org; Sat, 03 Jan 2015 03:15:47 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:42411) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Y7Jrv-0003kR-2T for emacs-devel@gnu.org; Sat, 03 Jan 2015 03:15:32 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Y7Jrr-0000gN-RU for emacs-devel@gnu.org; Sat, 03 Jan 2015 03:15:31 -0500 Original-Received: from relay5-d.mail.gandi.net ([2001:4b98:c:538::197]:38277) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Y7Jrr-0000dv-Km; Sat, 03 Jan 2015 03:15:27 -0500 Original-Received: from mfilter39-d.gandi.net (mfilter39-d.gandi.net [217.70.178.170]) by relay5-d.mail.gandi.net (Postfix) with ESMTP id AACE841C060; Sat, 3 Jan 2015 09:15:22 +0100 (CET) X-Virus-Scanned: Debian amavisd-new at mfilter39-d.gandi.net Original-Received: from relay5-d.mail.gandi.net ([217.70.183.197]) by mfilter39-d.gandi.net (mfilter39-d.gandi.net [10.0.15.180]) (amavisd-new, port 10024) with ESMTP id OkwxCw1gROEX; Sat, 3 Jan 2015 09:15:21 +0100 (CET) X-Originating-IP: 162.248.99.114 Original-Received: from localhost (114-99-248-162-static.reverse.queryfoundry.net [162.248.99.114]) (Authenticated sender: kelly@prtime.org) by relay5-d.mail.gandi.net (Postfix) with ESMTPSA id DECC941C05C; Sat, 3 Jan 2015 09:15:19 +0100 (CET) In-reply-to: X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2001:4b98:c:538::197 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:180935 Archived-At: Richard Stallman wrote: > There will be no need for browsers to try to choose between two > formats of a manual, if the only format we use is a form of HTML. That's true. I thought the consensus was to continue supporting the Info = format for the time being, add URL syntax to the Info browser, and dump t= he Info format (and standard HTML, as currently used for manual pages on = gnu.org) only after a new format was ready to replace it. That would mean= there would be a period when URLs were used for two formats (Info and HT= ML), so I proposed a way to handle that. But if URL syntax isn't going to= be introduced for the Info browser until the new format is ready to repl= ace both Info and the currently-used form of HTML, then my proposal to us= e redirection to handle both isn't necessary. > Rather, the two modes we will want a browser to handle are (1) locally > installed files and (2) files fetched with http over the web. > Since the same files could be accessed either way, we want to make > sure that the same file contents work both ways. This affects how > cross-refereces have to be handled. The solution to that, of course, is to simply have the browser fetch thro= ugh a cache, like standard web browsers do. To =E2=80=9Finstall=E2=80=9D = files locally, just fetch them, then pin them in the cache. Emacs release= s can come with the appropriate files preloaded (and pinned) in the cache= , so no network connection is needed to browse those files. To uninstall = files, just purge them from the cache, or just un-pin them and let them b= e automatically purged to make room for new data. For intra-domain cross-references (even inter-manual, so long as intra-do= main), use relative links, which is standard practice on the web. Web bro= wsers automatically convert relative links to absolute (based on the abso= lute URL that was used to fetch the page (and this URL is recorded in the= cache along with the page itself)), so relative links are never exposed = to users except when they look at a page's source code. The only time you= need absolute links in your manuals is for inter-domain cross-references= .