Minor updates to the doc

[Yegappan Lakshmanan]

Hi,

A few minor updates to the help text is below.

The Exuberant Ctags is no longer maintained (the last release

was in 2009). A maintained version of this is Universal Ctags.

I have updated the tagsrch.txt file to include this.

Also, it will be useful to include a tag for 'random' to the rand()

function.

- Yegappan

==================================================

diff --git a/runtime/doc/eval.txt b/runtime/doc/eval.txt
index 66033764c..6958ae793 100644
--- a/runtime/doc/eval.txt
+++ b/runtime/doc/eval.txt
@@ -7766,7 +7766,7 @@ range({expr} [, {max} [, {stride}]])                      
        *range()*
                        GetExpr()->range()
 <
 
-rand([{expr}])                                         *rand()*
+rand([{expr}])                                         *rand()* *random*
                Return a pseudo-random Number generated with an xoshiro128**
                algorithm using seed {expr}.  The returned number is 32 bits,
                also on 64 bits systems, for consistency.
diff --git a/runtime/doc/tagsrch.txt b/runtime/doc/tagsrch.txt
index 0b22deba1..e2cac9031 100644
--- a/runtime/doc/tagsrch.txt
+++ b/runtime/doc/tagsrch.txt
@@ -527,10 +527,13 @@ a tag for each "#defined" macro, typedefs, enums, etc.
 Some programs that generate tags files:
 ctags                  As found on most Unix systems.  Only supports C.  Only
                        does the basic work.
+universal ctags                A maintained version of ctags based on exuberant
+                       ctags. See https://ctags.io.
                                                        *Exuberant_ctags*
 exuberant ctags                This is a very good one.  It works for C, C++, Java,
                        Fortran, Eiffel and others.  It can generate tags for
                        many items.  See http://ctags.sourceforge.net.
+                       This is no longer maintained.
 etags                  Connected to Emacs.  Supports many languages.
 JTags                  For Java, in Java.  It can be found at
                        http://www.fleiner.com/jtags/.

[Bram Moolenaar]

Yegappan wrote:

> A few minor updates to the help text is below.
>
> The Exuberant Ctags is no longer maintained (the last release
> was in 2009). A maintained version of this is Universal Ctags.
> I have updated the tagsrch.txt file to include this.

Did anybody compare the two? Exuberant ctags is very fast, it's easy to
make it slower when adding new features.

> Also, it will be useful to include a tag for 'random' to the rand()
> function.

I'll include the patch, thanks.

--
Article in the first Free Software Magazine: "Bram Moolenaar studied
electrical engineering at the Technical University of Delft and
graduated in 1985 on a multi-processor Unix architecture."
Response by "dimator": Could the school not afford a proper
stage for the ceremony?

/// Bram Moolenaar -- Br...@Moolenaar.net -- http://www.Moolenaar.net \\\
/// sponsor Vim, vote for features -- http://www.Vim.org/sponsor/ \\\
\\\ an exciting new programming language -- http://www.Zimbu.org ///
\\\ help me help AIDS victims -- http://ICCF-Holland.org ///

[Gary Johnson]

On 2020-04-19, Bram Moolenaar wrote:
> Yegappan wrote:
>
> > A few minor updates to the help text is below.
> >
> > The Exuberant Ctags is no longer maintained (the last release
> > was in 2009). A maintained version of this is Universal Ctags.
> > I have updated the tagsrch.txt file to include this.
>
> Did anybody compare the two? Exuberant ctags is very fast, it's easy to
> make it slower when adding new features.

I haven't done a formal, quantitative comparison, but I switched
from Exuberant Ctags to Universal Ctags some years ago when I was
working on a product with a huge number of files and symbols.
I didn't notice any slowdown.

Regards,
Gary

[Yegappan Lakshmanan]

Hi Bram,

On Sun, Apr 19, 2020 at 1:59 PM Bram Moolenaar <Br...@moolenaar.net> wrote:

Yegappan wrote:

> A few minor updates to the help text is below.
>
> The Exuberant Ctags is no longer maintained (the last release
> was in 2009). A maintained version of this is Universal Ctags.
> I have updated the tagsrch.txt file to include this.

Did anybody compare the two?  Exuberant ctags is very fast, it's easy to
make it slower when adding new features.

To compare the two, I built the tags file for the Linux kernel source tree

and the results are:

Exuberant ctags: 1 minute and 1 second (485 MB tags file)

Universal ctags: 44 seconds (657 MB tags file)

As Universal ctags is based on exuberant ctags, all the command line

options are supported. It also supports a lot more languages.

Regards,

Yegappan

[Bram Moolenaar]

That sounds good. Thanks for checking.

--
For humans, honesty is a matter of degree. Engineers are always honest in
matters of technology and human relationships. That's why it's a good idea
to keep engineers away from customers, romantic interests, and other people
who can't handle the truth.
(Scott Adams - The Dilbert principle)