doctree
doctree copied to clipboard
platform/* の課題
platform/ 下のファイルがだいぶ古い感じがしますので,ここに気づいたことを書いておきます。
◎Ruby が動作するプラットフォーム https://docs.ruby-lang.org/ja/2.7.0/doc/platform=2findex.html
このページはリファレンスの目次や他のページからはリンクされていないようです。 しかし,検索エンジンにインデックスされていますので,メンテナンスは必要かと思います。 以下の課題があります。
- インストールガイドがリンク切れ(https://github.com/rurema/doctree/pull/2146 で解決~予定~)
- 箇条書きのレイアウトが崩れている( #2166 で解決)
- platform/GNU Hurd へのリンクがリンクになっていない
~~(追記)箇条書きがおかしいのは先頭の *
の前にインデントが無いことが原因と分かりました。
https://github.com/rurema/doctree/pull/2146 のマージを待ってからプルリクエストを作ります(コンフリクトを避けるため)。~~ →済
◎インデックス以外のページ(各プラットフォームのページ)
以下のものがあります。
- bccwin32.rd
- BeOS.rd
- Cygwin.rd
- DJGPP.rd
- DOSISH-support.rd
- emx.rd
- GNU%20Hurd.rd
- GNU.rd
- human68k.rd
- Mac.rd
- MacOSX.rd
- MinGW.rd
- mingw32.rd
- mswin32-compat.rd
- mswin32.rd
- mswince.rd
- OS2.rd
- os2_emx.rd
- Unix.rd
- VMS.rd
- Win32-native.rd
- Win32.rd
- WindowsCE.rd
削除してよいものも少なくないと思いますが,私にはどれがそうなのか分かりません。
削除するページを指示していただければ,他の箇所からのリンクが無いかを確認したうえで削除のプルリクエストを作ります。
DOSISH-support.rd については関連 issue https://github.com/rurema/doctree/issues/407 があります。
Ruby のリポジトリーの NEWS for Ruby 1.9.1 というファイルに
* Dropped
o No longer supports djgpp, bcc32, human68k, MacOS 9 or earlier,
VMS nor Windows CE.
という記述を見つけました。 また,NEWS for Ruby 2.3.0 には
サポートしているプラットフォームの変更
OS/2 はもうサポートされていません。
BeOS はもうサポートされていません。
Borland-C はもうサポートされていません。
Haiku は安定しています。ベストエフォートです。
とあります。
従って,以下は直ちに削除できます(インデックスページ以外からのリンクが無い)。
- BeOS.rd
- Mac.rd
- VMS.rd
- WindowsCE.rd
- mswince.rd(WindowsCE からの参照はある)
DOSISH 対応 からリンクされているものは以下のとおり。これらは DOSISH 対応のページで当該の記述を削除してからとなります。
- human68k.rd
- os2_emx.rd
- bccwin32.rd
特殊変数 $-I からリンクされているものは以下のとおり。これらも$-I
のページで当該の記述を削除する必要があります。
- bccwin32.rd
- DJGPP.rd
- emx.rd
Win32 からリンクされているものは以下のとおり。これらも当該の記述を削除する必要があります。
- DJGPP.rd
emx.rd,os2_emx.rd が消せたら OS2.rd も消せます。
ページの削除がひと通り終わったので,残る課題は各ページの内容ですね。 現状で(index.rd を除き)以下の 12 ページがあります。
- Cygwin
- DOSISH-support
- GNU
- GNUHurd
- MacOSX
- MinGW
- mingw32
- mswin32-compat
- mswin32
- Unix
- Win32-native
- Win32
いずれも古い感じがするのですが,どう直したらよいのか私には皆目わかりません。