On Wed, May 26 2021, Nicolas Goaziou wrote: > Hello, > > Xinglu Chen writes: > >> * gnu/packages/emacs-xyz.scm (emacs-org-pandoc-import): New variable. > > Thank you. It looks good with one minor nit below. > >> + (synopsis "Save yourself from non-Org formats") >> + (description "This package uses Pandoc to convert selected file types to >> +Org, so you never have to leave Org. There are two tiers of non-Org file >> +avoidance: >> + >> +@enumerate >> +@item The basic ``get me out of here'' --- >> +@code{org-pandoc-import-{to,as}-org} allows you to easily convert supported >> +non-Org files to an Org file/buffer with Pandoc >> + >> +@item The ``I don’t even want to see non-org files'' --- >> +@code{org-pandoc-import-transient-mode} is for you. What it does: >> +@itemize >> +@item (via file handlers) intercepts requests for non-Org files it knows it >> +can convert >> +@item uses @code{org-pandoc-import-to-org} to convert the file to a temporary >> +Org file >> +@item opens this Org file instead >> +@item exports back to the original non-Org file on save >> +@end itemize >> +@end enumerate") > > Could you make the synopsis and the description more neutral? E.g., we > can drop the "so you never have to leave Org" part, etc. OK, will do :)