Skip to content

docs, enh: add a target for generating .info files#76

Open
masatake wants to merge 1 commit intouniversal-ctags:masterfrom
masatake:texinfo
Open

docs, enh: add a target for generating .info files#76
masatake wants to merge 1 commit intouniversal-ctags:masterfrom
masatake:texinfo

Conversation

@masatake
Copy link
Copy Markdown
Member

Signed-off-by: Masatake YAMATO yamato@redhat.com

Signed-off-by: Masatake YAMATO <yamato@redhat.com>
@AmaiKinono
Copy link
Copy Markdown
Member

Thanks!

I can confirm it works well.

If a user manually installed Citre, they can add the docs dir to Info-directory-list to visit them by C-h i. However, I'm thinking for those who installed Citre use a package manager, like MELPA or straight.el (I use the latter one).

For them to automatically install the info files, we need to keep at least the *.texi files in the source tree. This is clear to see the default files used by MELPA to build the package:

 ("*.el" "*.el.in" "dir"
   "*.info" "*.texi" "*.texinfo"
   "doc/dir" "doc/*.info" "doc/*.texi" "doc/*.texinfo"
   (:exclude ".dir-locals.el" "test.el" "tests.el" "*-test.el" "*-tests.el"))

straight.el uses the same set of default files, as far as I know.

So what we need to do is:

  • Don't let git ignore *.texi files or *.info files. I think keeping *.texi files are better since they are the "source code".
  • Do you know any git tricks that automatically run $ make info when commit?
  • Let make build them into the root directory of Citre. Or we can still build them into docs, but then we need to modify the Citre recipe on MELPA.

@AmaiKinono
Copy link
Copy Markdown
Member

Also, I don't know if it can be done with texinfo: Can we convert README.md into a texinfo file, and the links in it (to those manuals) still work?

README.md covers most useful info users, and is often mentioned in user manuals.

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants