[ruby-dev:23110] Re: enable-install-rdoc (was Re: --prefix and DESTDIR for bccwin32)

山本です。

>敵を知らざれば一勝一敗す。まずは RDOC について調べてみます。

riって結構便利ですね・・・ブラウザをたどる必要がないのはいい感じです。

次のような点が改善されれば、デフォルトインストールでもそれほど抵抗がないかもしれません。

  a. RI Documant の生成速度の向上（今はPenII266で3分かかる）
  b. RI Document のファイル数の減少（今は2000個もある。速度的に必要なのだろうか）
  c. RI コマンドの速度の向上
  d. RI Document から .html や .chm が生成できるようになる（ソースのない配布環境用）

ただ、

  configure --disable-install-doc

は長いので、

  configure --disable-doc

のほうがいいと思います。

あと気になるのは、普通は install-doc というと HTML など、読めるドキュメントを
期待するのですが、あの大量のファイルは実は rdoc を使うときにも必要なく、
ri を使うときだけ必要だという点です。（d.が実現すれば、"doc"のほうがいいかもしれませんが）

  configure --disable-ri

のほうが誤解が少ないかもしれません。

下のパッチは、試しに configure --disable-doc にしてみたものです。
あと、生成ファイルの呼び名の違いが気になったので、統一してみました。

cvs diff -u -wb -p configure.bat Makefile.sub setup.mak (in directory E:\ruby-cvs\ruby\bcc32\)
Index: configure.bat
===================================================================
RCS file: /ruby/ruby/bcc32/configure.bat,v
retrieving revision 1.10
diff -u -w -b -p -r1.10 configure.bat
--- configure.bat	29 Feb 2004 08:22:48 -0000	1.10
+++ configure.bat	3 Mar 2004 09:13:28 -0000
@@ -18,8 +18,8 @@ if "%1" == "target" goto :target

 if "%1" == "--with-static-linked-ext" goto :extstatic

 if "%1" == "--program-suffix" goto :suffix

 if "%1" == "--program-name" goto :progname

-if "%1" == "--enable-install-doc" goto :enable-rdoc

-if "%1" == "--disable-install-doc" goto :disable-rdoc

+if "%1" == "--enable-doc" goto :enable-doc

+if "%1" == "--disable-doc" goto :disable-doc

 if "%1" == "-h" goto :help

 if "%1" == "--help" goto :help

   echo>> ~tmp~.mak 	"%1" \

@@ -59,12 +59,12 @@ goto :loop

   echo>> ~tmp~.mak 	-D"EXTSTATIC=static" \

   shift

 goto :loop

-:enable-rdoc

-  echo>> ~tmp~.mak 	-D"RDOCTARGET=install-doc" \

+:enable-doc

+  echo>> ~tmp~.mak 	-D"DOCTARGET=install-doc" \

   shift

 goto :loop

-:disable-rdoc

-  echo>> ~tmp~.mak 	-D"RDOCTARGET=install-nodoc" \

+:disable-doc

+  echo>> ~tmp~.mak 	-D"DOCTARGET=install-nodoc" \

   shift

 goto :loop

 :help

@@ -77,7 +77,7 @@ goto :loop

   echo   --target=TARGET         configure for TARGET [i386-bccwin32]

   echo Optional Package:

   echo   --with-static-linked-ext link external modules statically

-  echo   --disable-install-doc   do not install rdoc indexes during install

+  echo   --disable-doc   do not install RI documantation during install

   del ~tmp~.mak

 goto :exit

 :end

Index: Makefile.sub
===================================================================
RCS file: /ruby/ruby/bcc32/Makefile.sub,v
retrieving revision 1.53
diff -u -w -b -p -r1.53 Makefile.sub
--- Makefile.sub	29 Feb 2004 08:22:48 -0000	1.53
+++ Makefile.sub	3 Mar 2004 09:15:08 -0000
@@ -106,8 +106,8 @@ TESTUI = console
 !ifndef TESTS
 TESTS =
 !endif
-!ifndef RDOCTARGET
-RDOCTARGET = install-doc
+!ifndef DOCTARGET
+DOCTARGET = install-doc
 !endif
 !ifndef CFLAGS
 CFLAGS = -q $(DEBUGFLAGS) $(OPTFLAGS) $(PROCESSOR_FLAG) -w- -wsus -wcpt -wdup -wext -wrng -wrpt -wzdi
@@ -428,7 +428,7 @@ $(LIBRUBY_SO) $(LIBRUBY): $(LIBRUBY_A) $
 $(RUBYDEF):	$(LIBRUBY_A) miniruby$(EXEEXT)
 		$(MINIRUBY) $(srcdir)bcc32/mkexports.rb -output=$@ $(LIBRUBY_A)
 
-install:	install-nodoc $(RDOCTARGET)
+install:	install-nodoc $(DOCTARGET)
 install-all:	install-nodoc install-doc
 
 install-nodoc:	install-local install-ext
@@ -447,7 +447,7 @@ no-install-ext:	rbconfig.rb
 		$(MINIRUBY) $(srcdir)ext/extmk.rb -n $(EXTMK_ARGS) install
 
 install-doc: $(PROGRAM)
-		@echo Generating RDoc documentation
+		@echo Generating RI documentation
 		$(RUNRUBY) "$(srcdir)bin/rdoc" --all --ri --op "$(RIDATADIR)" "$(srcdir)"
 
 clean:		clean-ext clean-local
Index: setup.mak
===================================================================
RCS file: /ruby/ruby/bcc32/setup.mak,v
retrieving revision 1.10
diff -u -w -b -p -r1.10 setup.mak
--- setup.mak	1 Mar 2004 10:56:26 -0000	1.10
+++ setup.mak	3 Mar 2004 09:14:44 -0000
@@ -37,8 +37,8 @@ alpha-$(OS): -prologue- -alpha- -epilogu
 srcdir = $(srcdir:\=/)
 prefix = $(prefix:\=/)
 EXTSTATIC = $(EXTSTATIC)
-!if defined(RDOCTARGET)
-RDOCTARGET = $(RDOCTARGET)
+!if defined(DOCTARGET)
+DOCTARGET = $(DOCTARGET)
 !endif
 |
 	@cpp32 -I$(srcdir) -P- -o$(MAKEFILE) > nul &&|