From: "Robert J. Chassell" <bob@rattlesnake.com>
Subject: Re: Do you understand this?
Date: Mon, 7 Mar 2005 23:46:52 +0000 (UTC) [thread overview]
Message-ID: <m1D8Rw4-0004RGC@rattlesnake.com> (raw)
In-Reply-To: <422C8B23.109@gnu.org> (message from Jason Rumney on Mon, 07 Mar 2005 17:10:59 +0000)
Jason Rumney rightly noted that
In the Emacs manual, we need to explain how the user configures
this in Emacs. Describing what RFC2616 says is not very useful
...
Good point. How about putting the explanation in a comment in
emacs/lisp/url/url-vars.el
just after
(defvar url-mime-accept-string nil
"String to send to the server in the Accept: field in HTTP requests.")
? Or perhaps in the `Commentary:' section of
emacs/lisp/url/url.el
with some other remarks, too. (I do not know enough to have any idea
what the `other remarks' should say.)
Here is the explanation, slightly changed from before, in a format for
an Emacs Lisp library. Please check this wording. I think it is a
little clearer than before.
;; An `Accept:' or `Accept-Charset' statement, or a `headers' as it is
;; often called, allows you, a client, to specify the priority or
;; weighing of the type of statement you would like a server to
;; accept.
;;
;; In contrast to their precedence in English text, commas separate
;; _bigger_ groupings than semi-colons, which are used to prefix
;; weightings or priority values. Priority values go from 0.0 to 1.0,
;; with 1.0 being highest. When a priority or weighting value is not
;; listed the value is presumed to be 1.0. Moreover, an `Accept:' or
;; `Accept-Charset' list need not be in priority or precedence order.
;;
;; Thus, an accept statement such as
;;
;; Accept: text/plain;
;; q=0.5, text/html, text/x-dvi;
;; q=0.8, text/x-c
;;
;; could be reformatted as
;;
;; Accept: text/plain; q=0.5,
;; text/x-dvi; q=0.8,
;; text/html ; q=1.0,
;; text/x-c ; q=1.0
;;
;; This latter expression shows the list in order from lower to higher
;; priority. Both `text/html' and `text/x-c' are of equal (and
;; highest) priority.
;;
;; When a client sends in an HTTP request for a resource, the above
;; `Accept:' statement tells the server that the user prefers either
;; an HTML or text/x-c document. If neither of those reprsentations
;; is available, then DVI is next preference. If none of those three
;; are available, then plain text should be sent. If neither plain
;; text, DVI, HTML nor x-c are available, then the server's response
;; should indicate that it is failing to find a representation that
;; satisfies the request.
--
Robert J. Chassell
bob@rattlesnake.com GnuPG Key ID: 004B4AC8
http://www.rattlesnake.com http://www.teak.cc
next prev parent reply other threads:[~2005-03-07 23:46 UTC|newest]
Thread overview: 12+ messages / expand[flat|nested] mbox.gz Atom feed top
2005-03-06 19:11 Do you understand this? Richard Stallman
2005-03-06 20:44 ` Nic Ferrier
2005-03-06 22:32 ` Robert J. Chassell
2005-03-06 22:58 ` Andreas Schwab
2005-03-06 23:05 ` Jason Rumney
2005-03-07 15:37 ` Robert J. Chassell
2005-03-07 17:10 ` Jason Rumney
2005-03-07 23:46 ` Robert J. Chassell [this message]
2005-03-08 0:34 ` Nic Ferrier
2005-03-08 18:41 ` Robert J. Chassell
2005-03-09 16:58 ` Richard Stallman
2005-03-06 23:12 ` Nic Ferrier
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=m1D8Rw4-0004RGC@rattlesnake.com \
--to=bob@rattlesnake.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.