Beefy Boxes and Bandwidth Generously Provided by pair Networks
No such thing as a small change
 
PerlMonks  

Re^3: Breathing life into the (Emacs) cperl-mode

by LanX (Sage)
on Jul 03, 2020 at 10:02 UTC ( #11118859=note: print w/replies, xml ) Need Help??


in reply to Re^2: Breathing life into the (Emacs) cperl-mode
in thread Breathing life into the (Emacs) cperl-mode

Hi

  • division: the final .el should be a single one, sure. I was thinking of a build and testing process triggered from a Perl script joining different parts. Testing with different emacs versions° is not easy and you'll find more contributors providing Perl tests.
  • docs: sorry, you misunderstood me, cperl has a long list of one liner description for each Perl command. IMHO these should be outsourced.
  • info: What you mean is the hypertext help system which relies on static perldocs in "info" format. Info is great for navigation of deep manuals, perldocs are rather flat and should be IMHO better displayed with "woman.el" (man doesn't work on windows).
  • if you drop support for older or other versions like XEmacs you should maybe consider renaming the fork of cperl-mode

On a different note: elisp regexing is a PITA because of slasheritis and pretty unreadable. (Btw: XEmacs solved this with raw strings)

I was thinking of translating Perl regex to lisp to open up for a broader audience.

Cheers Rolf
(addicted to the Perl Programming Language :)
Wikisyntax for the Monastery

°) and Perl versions and extensions

  • Comment on Re^3: Breathing life into the (Emacs) cperl-mode

Replies are listed 'Best First'.
Re^4: Breathing life into the (Emacs) cperl-mode
by haj (Curate) on Jul 23, 2020 at 23:39 UTC
    About Perl documentation...
    ...perldocs are rather flat and should be IMHO better displayed with "woman.el" (man doesn't work on windows).

    Update: I've just pushed a cperl-mode where M-x cperl-perldoc just works on Windows. I didn't find woman.el particularly rewarding, though, and I took a different route. On the plus side, hyperlinks in POD files now work, and are resolved in your local installation (unless they are https links). Many perldoc pages are flat, but others like the Moose::Cookbook make more fun when links work.

    Other documentation functions of cperl-mode will also be made available on Windows, as my time permits.

    The code is at cperl-mode.el on GitHub, there's also a List of changes.

    I've also completed the FSF paperwork, so there are chances that some changes will make their way into the official Emacs distribution.

Re^4: Breathing life into the (Emacs) cperl-mode
by haj (Curate) on Jul 03, 2020 at 12:46 UTC

    Sorry, I'm afraid that I'm going to disappoint you...

    • division: I fail to see how a division helps with either testing with different emacs versions or finding contributors providing Perl tests. I do see, however, some overhead to set up that process and document how to use it. So that's still pretty low on my priority list.
    • Outsourcing docs: That is another job for Shouldbedone-Man. I don't see enough benefit right now.
    • info format: Having convenient access to perldocs documentation from within Emacs is a valid requirement. The requirement is not exactly new, but the tool suggested in the answer to Sean's article seems to have rotted away. So it's either getting pod2info or pod2texi back to life, or ... but wait... It seems that you already have a solution. Care to share?
    • The decision to drop support for older and other versions hasn't be done by me, but by the Emacs maintainers, before I started to hack on cperl-mode. I've only removed some conditionals where cperl-mode worked around XEmacs quirks, or provided workarounds for old Emacs versions. I intend my work to be a drop-in replacement for the cperl-mode which comes with Emacs - or maybe even become the maintainer of cperl-mode, a position which has been vacant for quite some time now. So, no, renaming is not an option.
    I was thinking of translating Perl regex to lisp to open up for a broader audience.

    Excellent! Please go ahead!

      > Sorry, I'm afraid that I'm going to disappoint you...

      You are not disappointing me at all, you asked for opinions I shared mine in the hope they might be helpful. :)

      Cheers Rolf
      (addicted to the Perl Programming Language :)
      Wikisyntax for the Monastery

Re^4: Breathing life into the (Emacs) cperl-mode
by haj (Curate) on Aug 07, 2020 at 16:45 UTC
    Another update:
    perldocs are rather flat and should be IMHO better displayed with "woman.el" (man doesn't work on windows).

    As it turns out, this is already available. Not from Emacs nor ELPA/MELPA, but there's Emacs::PDE on CPAN. This distribution provides, among other tools, M-x perldoc which is using WoMan and works quite fine on Windows. Even better, there's a command M-x perldoc-tree which offers all local docs in a nice tree view.

    This, of course, makes a refurbishment of the perldoc stuff in cperl-mode a lot less interesting.

      Yeah I saw this already, problem is PDE is mostly abandoned, and many things don't work anymore.

      There are also other projects/bundles

      That's why I'd rather prefer decomposing features into modules which can be maintained independently...

      Cheers Rolf
      (addicted to the Perl Programming Language :)
      Wikisyntax for the Monastery

        Yeah I saw this already, problem is PDE is mostly abandoned, and many things don't work anymore.

        There is an amazing shortage of bug reports for the distribution, though. Can you share some cases? I wonder if the author even knows what doesn't work anymore?

        Anyway, his perldoc stuff seems to work quite fine on Windows, so it's hard for me to get motivated to duplicate that work.

        There are also other projects/bundles

        ...In quite similar state of decay, I guess? EmacsWiki has a rich list of stuff that seems to have worked at some point in time.

        That's why I'd rather prefer decomposing features into modules which can be maintained independently...

        I've been through this cycle at least three times in my career. Decomposing without commitment and governance leads to independent bitrot. At some time, the multitude of module versions fail to cooperate with each other, and the trend goes to "this can't be managed any more, we need an intergrated solution". The Emacs repository, for example, is a monstrosity. But only the fact that cperl-mode is part of that monstrosity has ensured that cperl-mode still works with Emacs 28, while many of the independent features, including forks of cperl-mode, turned out to be not sufficiently maintained.

        I guess I'll contact the authors of some of those independently more-or-less maintained packages and ask them about their plans. Maybe some stuff just needs to be buried for good.

        Sometimes it's better to light a flamethrower than curse the darkness. -- Terry Pratchett

Log In?
Username:
Password:

What's my password?
Create A New User
Domain Nodelet?
Node Status?
node history
Node Type: note [id://11118859]
help
Chatterbox?
and the web crawler heard nothing...

How do I use this? | Other CB clients
Other Users?
Others drinking their drinks and smoking their pipes about the Monastery: (5)
As of 2021-10-22 14:08 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?
    My first memorable Perl project was:







    Results (85 votes). Check out past polls.

    Notices?