ローカルルール

[68] Discord Developer Portal — Documentation — Reference, 2023-05-31T22:18:22.000Z, 2023-06-01T05:36:42.178Z https://discord.com/developers/docs/reference#user-agent

User-Agent: DiscordBot ($url, $versionNumber)

Clients may append more information and metadata to the end of this string as they wish.

USEFOR draft (電子ニュース・メッセージ) での規定に関して

[44] product の中身が HTTP では token でしたが、 usefor では value になりました。このおかげで、漢字を使った名前とかも入れられます。

• [45] User-Agent-content = product-token *( CFWS product-token )
• [46] User-Agent-header = "User-Agent" ":" SP User-Agent-content *( ";" other-parameter )
• [47] product-token = value [ "/" product-version ]
• [48] product-version = value

• [17] ietf-usefor の議論をちょっと目を離した隙に、 product が token に変わってしまいました。 (HTTP と同じになった。) だから "A User Agent" も "なんかの利用者エージェント" も駄目になりました。 (なんでそうなったのかは、議論を追えてないので分かりませぬ。)
• [18] 17: 電子ニュース記事の国際化を目指した usefor-article にとって大きな後退です。たとえこのままの仕様で RFC になってしまっても、 UTF-8 が使える旧仕様のメッセージを流し続けましょう。そうすれば son-of-usefor でちゃんとなるかもしれん。
• [26] 2002-12-22 21:46 >>10: comment の中なら encoded-word でも OK ですね。
• [27] product-version に quoted-string を使った例: User-Agent: FooNews/"1.0(Beta1)"
• [28] encoded-word を comment 中に使った例: User-Agent: "Bar@"/1.2 (=?us-ascii?q?Micro=24oft_Windoze_XP?= ; i686)
• [31] 2002-12-25 18:08 >>17: まだ関係する記事を全部読んでないんですが、どうも電子メイルに gatewaying する時に product の部分が UTF-8 だったらどうするのかが問題になって、 encoded-word にするのは鬱だし、いっそのことやめちまえになったっぽいです。ま た e n c o d e d - w o r d か !

Client-Specific Web Services by Using User Agent Attributes

[40] UA: にクライアント情報を一杯詰め込んじまおうという Client-Specific Web Services by Using User Agent Attributes http://www.w3.org/TR/NOTE-agent-attributes W3C NOTE 12-30-1997。 仕様考えた会社位しか実装例が無いらしい(w)。

• [41] User-Agent: AVE-Front/2.0 (BrowserInfo Screen=640x480x256; InputMethod=REMOCON,KEYBOARD; Page=512K; Product=XXXX/Internet-TV; HTML-Level=3.2; Language=ja.JIS; Category=TV; CPU=SH2; Storage=NO;)

[42] 一応 BNF とかでちゃんと定義してある。

1. Prop_def = "(" "BrowserInfo" Prop_items ")"
2. Prop_items = Prop_item | Prop_items Prop_item
3. Prop_item = Prop_name "=" Prop_value ";"
4. Prop_name = STRING
5. Prop_value = STRING

The upper case and lower case in describing Prop_name and Prop_value

have to be discriminated.

1. Prop_name = "Screen" | "InputMethod" | "Page" | "Product" | "HTML-Level" | "Language" | "Category" | "CPU" | "Storage"

"Screen", "InputMethod", "Page", "Product", "HTML-Level" は強く推奨らしいぞ。

"Screen" の値: width (pixels) "x" height (pixels) "x" colors (colors は 2, 4, 8, 16, 32, 64, 128, 256, 32K, 64K, 16M のどれか)

"InputMethod" の値: PEN, KEYBOARD, MOUSE, REMOCON, BUTTON, JOG, ... のどれか(複数可)を、読点区切り。 (例では読点の後に SP が。)

以下説明略。面倒だ:-) 理解する側の実装は (まじめにしよーとすると) 面倒だと思うぞ。値の定義がいい加減だ。

ところで HTML 1.1 ってなに?

RFC 2616 に適合する例

• User-Agent: CERN-LineMode/2.15 libwww/2.17b3
• User-Agent: tin/1.2-PL2
• User-Agent: tin/1.3-950621beta-PL0 (Unix)
• User-Agent: tin/unoff-1.3-BETA-970813 (UNIX) (Linux/2.0.30 (i486))
• User-Agent: tin/pre-1.4-971106 (UNIX) (Linux/2.0.30 (i486))
• User-Agent: Mozilla/4.02b7 (X11; I; en; HP-UX B.10.20 9000/712)
• User-Agent: Microsoft-Internet-News/4.70.1161
• User-Agent: Gnus/5.4.64 XEmacs/20.3beta17 ("Bucharest")
• User-Agent: Pluto/1.05h (RISC-OS/3.1) NewsHound/1.30
• User-Agent: inn/1.7.2
• User-Agent: telnet
• User-Agent: T-gnus/6.14.4 (based on Gnus v5.8.7) (revision 01) REMI/1.14.1 (=?ISO-8859-4?Q?Mushigawa=F2sugi?=) Chao/1.14.1 (=?ISO-8859-4?Q?Rokujiz?= =?ISO-8859-4?Q?=F2?=) APEL/10.2 MULE XEmacs/21.2 (beta33) (Melpomene) (i686-pc-linux)

USEFOR draft に適合する例

• HTTP に適合するものは、 usefor にも適合します。
• User-Agent: "秀丸エディタ"/3.0 "Microsoft(R) Windows(R) Millenium Edition" (Windows Me)
• [49] User-Agent: "西瓜割"/1.5 Message-pm/1.23

間違った例とこれへの対処について

• [1]User-Agent: Mozilla/4.7 [ja]C-{C-UDP; EBM-SONY2}
• [2]User-Agent: DoCoMo/1.0/N503i/c10
• [3]User-Agent: H-Hash@StudyingHTTP.NET
• [4]User-Agent: HttpGet/1.0(Win32; GUI; ix86)
• [5]User-Agent: ネットスケープ 2.0

[34] 間違った例でもそれなりに使われている以上、対応する必要もあるでしょう。 (でも頭が痛いなあ。)

[6] >>1 は、 [ja] 以降の部分で []{}; を使うのを止めるか、全体を comment にしてしまうべきものでしょう。 usefor 的には {} は OK なんですが。あるいは全体を quoted-string にするとか。 読む側としては、不正だから無視するのが一番楽。 どうしても読むなら、 http-token の代わりに *<"/" を除く CHAR> を使うとか。それでも後半が2部分に分かれますが。

[7] >>2 は、 N503i 以降を comment にするか、区切りを "/" じゃなくて "-" にするとかすべきだったと。読む実装側は・・・悩ましい。

[8] >>3 は、 usefor なら quoted-string にしておくとか。 HTTP では無理だねえ。 (こんなところにメイルアドレスなんて入れるなよ。) 読む側は 1 と同じ対処かな。

[9] >>4 は、 comment の前に SP 入れなさい、って話。 HTTP では必須らしいけど、 usefor 的には無くても OK だねぇ。互換性のために入れた方がいいと 思うけど。読む側は無くても解釈できるのが望ましかろう。

[10] >>5 は、実際、生 ISO-2022-JP (ならまだ良い。) とか EUC-JP とか シフトJIS とか入れる人が少なくないらし。御丁寧にも encoded-word 使う人とかもいるらしいねえ。 なんにせよ、 http-token 以外の文字を 使う時は、 quoted-string にしましょ。 (但し usefor only.)

古い版の MacIE は、日本語版では「ネットスケープ 2.0」とかほざくらしい。 シフト JIS でね。英語版では 「Mozilla/2.0」だったと思われ。藁。

[35] http://www.dais.is.tohoku.ac.jp/logs/agentgripes.html からめぼしい(謎)もの。 (適当に上の方から。)

• [11]User-Agent: A.G.E.N.T. http://masui.net/agent/libwww-perl/5.44
• [12]User-Agent: Acoon Robot v1.50.001 (www.acoon.de)

[13] >>11 URI 生書きいや〜ん。 >>12 構文としては問題ないけど名前/版形式きぼんぬ。

• [51] どうせ規格に違反するなら、 >>44 の usefor の改良された方法で quoted-string を使うようにしていった方が、見よう見まねの実装で正しい値を使うようになるんじゃないかと思います。(甘いかな。) ですから新しい実装は、 >>44 の usefor の形式に合致する値を出力するのが望ましいと考えられます。
• [52] >>51 の考え方からすれば、現実的に表現力が小さいだけで何の役にも立っていない今の HTTP の書式を無理に使うよりは、 >>44 の usefor のより自由な方式に (現状では HTTP RFC と一致しなくても) 切り替えていった方が良いかもしれません。
• [53] >>10 HTTP/1.0 (RFC1945) では、 %x80-FF は ISO-8859-1 と解釈しても良いのであって強制ではありませんから、注釈の中ならシフト JIS を入れたり日本語 EUC を入れたり Big5 を入れたりしても問題ありませんね。して欲しくないけど。更に注釈外の生書きはもちろん駄目だけど。
• [54] >>53 また、 encoded-word を使う場合も注釈内なら構いませんが、注釈外はいけませんね。 (HTTP の場合)
• [55] 但し、 >>44- のように電子ニュースの手法を使って勝手に拡張してしまうなら、 "=?us-ascii?q?A_Sample_User_Agent?= (ASUA)"/"2.45 =?us-ascii?q?=28Lilly=29?=" みたいなのもありだと思います。 (MIME 的には quoted-string の中に encoded-word を入れるのはよくないんだけど、 HTTP 的にはあまり気にしない。)
• [56] もちろん、 >>55 の例は例であって、 US-ASCII だけの文字列を encoded-word にするなんてばかげたことは (普通は) しないで下さい、念のため。