emacs-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Convert README.org to plain text README while installing package


From: Stefan Monnier
Subject: Re: Convert README.org to plain text README while installing package
Date: Tue, 07 Jun 2022 13:55:04 -0400
User-agent: Gnus/5.13 (Gnus v5.13) Emacs/29.0.50 (gnu/linux)

> From 9d973044a346860d3fc6164fe75ad8cd9721a595 Mon Sep 17 00:00:00 2001
> From: Philip Kaludercic <philipk@posteo.net>
> Date: Mon, 6 Jun 2022 12:34:40 +0200
> Subject: [PATCH] Render Org documentation in a plain-text README-elpa file
>
> * elpa-admin.el (elpaa--make-one-tarball-1): Call elpaa--write-plain-readme.
> (elpaa--write-plain-readme): Add new function.

That looks OK, feel free to push that to `elpa-admin`.
Comments:
- you'd get more bonus points by arranging for the code
  to (re)use the existing plain text (which is currently produced later
  when (re)generating the HTML page, so it would take a fair bit of
  code reorg to get that.  In the mean time, a FIXME comment seems
  in order).
- Your code may end up "rendering" a Markdown file for no obvious benefit
  since the rendering is a no-op (tho I think this is very hypothetical
  and likely can't happen because of other constraints).
- We might also add a `README-elpa` file when the readme file has a name
  not recognized by `package--get-description`.


        Stefan




reply via email to

[Prev in Thread] Current Thread [Next in Thread]