ruby--ruby/tool/strip-rdoc.rb

#!ruby
# frozen_string_literal: true

# Filter for preventing Doxygen from processing RDoc comments.
# Used by the Doxygen template.

print ARGF.binmode.read.tap {|src|
  src.gsub!(%r|(/\*[!*])(?:(?!\*/).)+?^\s*\*\s?\-\-\s*$(.+?\*/)|m) {
    marker = $1
    comment = $2
    comment.sub!(%r|^\s*\*\s?\+\+\s*$.+?(\s*\*/)\z|m, '\\1')
    marker + comment
  }
}
* Doxyfile.in: new file. Template of a configuration file for Doxygen. Intorduces C-level API reference generation with Doxygen. * tool/file2lastrev.rb: wrapper script that abstracts subversion and git-svn. * tool/strip-rdoc.rb: filter for preventing doxygen from processing rdoc comments. * configure.in: (Doxyfile): Doxyfile is generated together with Makefile. (PACKAGE): configuration $(PACKAGE) is necessary for $(docdir). * instruby.rb: adds a new install target 'capi' * common.mk (capi): new target that generates C API documents with Doxygen. (install-capi): new target. (pre-install-capi): ditto. (do-install-capi): ditto. (post-install-capi): ditto. git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@20919 b2dd03c8-39d4-4d8f-98ff-823fe69b080e 2008-12-22 08:19:08 -05:00			`#!ruby`
tool/strip-rdoc.rb: optimize This script is called from Doxygen many times. Worth optimising. [ci skip] 2020-12-26 00:45:57 -05:00			`# frozen_string_literal: true`
* Doxyfile.in: new file. Template of a configuration file for Doxygen. Intorduces C-level API reference generation with Doxygen. * tool/file2lastrev.rb: wrapper script that abstracts subversion and git-svn. * tool/strip-rdoc.rb: filter for preventing doxygen from processing rdoc comments. * configure.in: (Doxyfile): Doxyfile is generated together with Makefile. (PACKAGE): configuration $(PACKAGE) is necessary for $(docdir). * instruby.rb: adds a new install target 'capi' * common.mk (capi): new target that generates C API documents with Doxygen. (install-capi): new target. (pre-install-capi): ditto. (do-install-capi): ditto. (post-install-capi): ditto. git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@20919 b2dd03c8-39d4-4d8f-98ff-823fe69b080e 2008-12-22 08:19:08 -05:00
tool: add descriptions and fix typos * tool/asm_parse.rb: add description * tool/change_maker.rb: ditto * tool/downloader.rb: ditto * tool/eval.rb: ditto * tool/expand-config.rb: ditto * tool/extlibs.rb: ditto * tool/fake.rb: ditto * tool/file2lastrev.rb: ditto * tool/gem-unpack.rb: ditto * tool/gen_dummy_probes.rb: ditto * tool/gen_ruby_tapset.rb: ditto * tool/generic_erb.rb: ditto * tool/id2token.rb: ditto * tool/ifchange: ditto * tool/insns2vm.rb: ditto * tool/instruction.rb: ditto * tool/jisx0208.rb: ditto * tool/merger.rb: ditto * tool/mkrunnable.rb: ditto * tool/node_name.rb: ditto * tool/parse.rb: ditto * tool/rbinstall.rb: ditto * tool/rbuninstall.rb: ditto * tool/rmdirs: ditto * tool/runruby.rb: ditto * tool/strip-rdoc.rb: ditto * tool/vcs.rb: ditto * tool/vtlh.rb: ditto * tool/ytab.sed: ditto * tool/enc-unicode.rb: fix typo * tool/mk_call_iseq_optimized.rb: ditto * tool/update-deps: ditto [ruby-core:76215] [Bug #12539] by Noah Gibbs <the.codefolio.guy@gmail.com> git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@55564 b2dd03c8-39d4-4d8f-98ff-823fe69b080e 2016-07-02 17:01:04 -04:00			`# Filter for preventing Doxygen from processing RDoc comments.`
			`# Used by the Doxygen template.`

tool/strip-rdoc.rb: optimize This script is called from Doxygen many times. Worth optimising. [ci skip] 2020-12-26 00:45:57 -05:00			`print ARGF.binmode.read.tap {\|src\|`
			`src.gsub!(%r\|(/\[!])(?:(?!\/).)+?^\s\\s?\-\-\s$(.+?\*/)\|m) {`
			`marker = $1`
			`comment = $2`
			`comment.sub!(%r\|^\s\\s?\+\+\s$.+?(\s\*/)\z\|m, '\\1')`
			`marker + comment`
			`}`
			`}`