Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

CPAN shell - online help not clear #6863

Closed
p5pRT opened this issue Oct 23, 2003 · 8 comments
Closed

CPAN shell - online help not clear #6863

p5pRT opened this issue Oct 23, 2003 · 8 comments

Comments

@p5pRT
Copy link

p5pRT commented Oct 23, 2003

Migrated from rt.perl.org#24275 (status was 'resolved')

Searchable as RT24275$

@p5pRT
Copy link
Author

p5pRT commented Oct 23, 2003

From Michael.Jacob@SCHERING.DE

Created by micaja@de.ibm.com

The online help of the CPAN shell has this entry​:

r NONE reinstall recommendations

I checked with multiple coworkers and all of them (including
me) misunderstood this as a command installing something.
It should be made clear this command only checks version.
Maybe​:

r NONE version check installed modules

or

r NONE list updatable modules

or

r NONE recommend module updates

Perl Info

Flags:
    category=utilities
    severity=low

Site configuration information for perl v5.8.0:

Configured by Gerrit at Fri Aug 29 11:53:54 CEST 2003.

Summary of my perl5 (revision 5.0 version 8 subversion 0) configuration:
  Platform:
    osname=cygwin, osvers=1.3.22(0.7832), archname=cygwin-multi-64int
    uname='cygwin_nt-5.0 ismene 1.3.22(0.7832) 2003-03-18 09:20 i586
unknown unknown cygwin '
    config_args='-de -Dmksymlinks -Dusemultiplicity -Duse64bitint
-Doptimize=-O3 -Dman3ext=3pm'
    hint=recommended, useposix=true, d_sigaction=define
    usethreads=undef use5005threads=undef useithreads=undef
usemultiplicity=define
    useperlio=define d_sfio=undef uselargefiles=define usesocks=undef
    use64bitint=define use64bitall=undef uselongdouble=undef
    usemymalloc=y, bincompat5005=undef
  Compiler:
    cc='gcc', ccflags ='-DPERL_USE_SAFE_PUTENV -fno-strict-aliasing',
    optimize='-O3',
    cppflags='-DPERL_USE_SAFE_PUTENV -fno-strict-aliasing'
    ccversion='', gccversion='3.2 20020927 (prerelease)', gccosandvers=''
    intsize=4, longsize=4, ptrsize=4, doublesize=8, byteorder=12345678
    d_longlong=define, longlongsize=8, d_longdbl=define, longdblsize=12
    ivtype='long long', ivsize=8, nvtype='double', nvsize=8, Off_t='off_t',
lseeksize=4
    alignbytes=8, prototype=define
  Linker and Libraries:
    ld='ld2', ldflags =' -s -L/usr/local/lib'
    libpth=/usr/local/lib /usr/lib /lib
    libs=-lgdbm -ldb -lcrypt -lutil -lgdbm_compat
    perllibs=-lcrypt -lutil -lgdbm_compat
    libc=/usr/lib/libc.a, so=dll, useshrplib=true, libperl=libperl.a
    gnulibc_version=''
  Dynamic Linking:
    dlsrc=dl_dlopen.xs, dlext=dll, d_dlsymun=undef, ccdlflags=' -s'
    cccdlflags=' ', lddlflags=' -s -L/usr/local/lib'

Locally applied patches:



@INC for perl v5.8.0:
    /usr/lib/perl5/5.8.0/cygwin-multi-64int
    /usr/lib/perl5/5.8.0
    /usr/lib/perl5/site_perl/5.8.0/cygwin-multi-64int
    /usr/lib/perl5/site_perl/5.8.0
    /usr/lib/perl5/site_perl
    .


Environment for perl v5.8.0:
    HOME=/home/MichaelJacob
    LANG (unset)
    LANGUAGE (unset)
    LD_LIBRARY_PATH (unset)
    LOGDIR (unset)

PATH=/usr/local/bin:/usr/bin:/bin:/cygdrive/c/WINNT/system32:/cygdrive/c/WINNT:/cygdrive/c/WINNT/system32/WBEM:/cygdrive/c/perl580/bin:/usr/bin:/cygdrive/c/Program

Files/UltraEdit:/cygdrive/c/PROGRA~1/IBM/SQLLIB/BIN:/cygdrive/c/PROGRA~1/IBM/SQLLIB/FUNCTION:/cygdrive/c/PROGRA~1/IBM/SQLLIB/SAMPLES/REPL:/cygdrive/c/WINNT/system32:/cygdrive/c/WINNT:/cygdrive/c/WINNT/system32/WBEM:/cygdrive/c/perl580/bin:/usr/bin:/usr/X11R6/bin
    PERL_BADLANG (unset)
    SHELL (unset)



@p5pRT
Copy link
Author

p5pRT commented Jul 12, 2005

From @schwern

[Michael.Jacob@​SCHERING.DE - Thu Oct 23 06​:01​:05 2003]​:
The online help of the CPAN shell has this entry​:

r NONE reinstall recommendations

I checked with multiple coworkers and all of them (including
me) misunderstood this as a command installing something.
It should be made clear this command only checks version.

You're right, that's not very clear.

I went with "updatable modules" even though that loses the "r" mnemonic.
"reinstallable modules" just didn't seem to properly describe "listing
the modules which have newer versions than you have installed".

Also fixed a grammar nit in the "i" docs.

@p5pRT
Copy link
Author

p5pRT commented Jul 12, 2005

From @schwern

CPAN.pm.patch
--- lib/CPAN.pm	2005/07/12 06:27:48	1.4
+++ lib/CPAN.pm	2005/07/12 06:29:38
@@ -1387,8 +1387,8 @@
 Display Information
  command  argument          description
  a,b,d,m  WORD or /REGEXP/  about authors, bundles, distributions, modules
- i        WORD or /REGEXP/  about anything of above
- r        NONE              reinstall recommendations
+ i        WORD or /REGEXP/  about any of the above
+ r        NONE              updatable modules
  ls       AUTHOR            about files in the author's directory
 
 Download, Test, Make, Install...

@p5pRT
Copy link
Author

p5pRT commented Jul 12, 2005

The RT System itself - Status changed from 'new' to 'open'

@p5pRT
Copy link
Author

p5pRT commented Jul 13, 2005

From @steve-m-hay

Michael G Schwern via RT wrote​:

[Michael.Jacob@​SCHERING.DE - Thu Oct 23 06​:01​:05 2003]​:
The online help of the CPAN shell has this entry​:

r NONE reinstall recommendations

I checked with multiple coworkers and all of them (including
me) misunderstood this as a command installing something.
It should be made clear this command only checks version.

You're right, that's not very clear.

I went with "updatable modules" even though that loses the "r" mnemonic.
"reinstallable modules" just didn't seem to properly describe "listing
the modules which have newer versions than you have installed".

Also fixed a grammar nit in the "i" docs.

Thanks. Applied as change 25132.

I changed it to "report updatable modules" to retain the "r" mnemonic.


Radan Computational Ltd.

The information contained in this message and any files transmitted with it are confidential and intended for the addressee(s) only. If you have received this message in error or there are any problems, please notify the sender immediately. The unauthorized use, disclosure, copying or alteration of this message is strictly forbidden. Note that any views or opinions presented in this email are solely those of the author and do not necessarily represent those of Radan Computational Ltd. The recipient(s) of this message should check it and any attached files for viruses​: Radan Computational will accept no liability for any damage caused by any virus transmitted by this email.

@p5pRT
Copy link
Author

p5pRT commented Jul 13, 2005

From @steve-m-hay

Now fixed in bleadperl so should be in 5.8.8, otherwise in 5.10.

@p5pRT
Copy link
Author

p5pRT commented Jul 13, 2005

@steve-m-hay - Status changed from 'open' to 'resolved'

@p5pRT p5pRT closed this as completed Jul 13, 2005
@p5pRT
Copy link
Author

p5pRT commented Jul 13, 2005

From @schwern

On Wed, Jul 13, 2005 at 09​:19​:14AM +0100, Steve Hay wrote​:

You're right, that's not very clear.

I went with "updatable modules" even though that loses the "r" mnemonic.
"reinstallable modules" just didn't seem to properly describe "listing
the modules which have newer versions than you have installed".

Also fixed a grammar nit in the "i" docs.

Thanks. Applied as change 25132.

I changed it to "report updatable modules" to retain the "r" mnemonic.

That's a pretty lousy mnemonic as they all "report" something. Also none
of the other descriptions mention that they "report" or "display". This
is assumed from the header "Display Information".

Better to drop the mnemonic than use a misleading or vague one.

--
Michael G Schwern schwern@​pobox.com http​://www.pobox.com/~schwern
Ahh email, my old friend. Do you know that revenge is a dish that is best
served cold? And it is very cold on the Internet!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

1 participant