ABINIT Discussion Forums

Hi all,

after installing ABINIT, its manual page can be found in share/doc/abinit/manpages. However, man won't find any entry for "abinit" even if this directory is appended to MANPATH, since man only finds pages in directories man1/, man2/, man3/, ... So one has to manually create a directory "man1" and place "abinit.1" there. I understand this is pretty simple, so can we fix the makefile to place "abinit.1" in its right "man1" directory?

It is worth noticing that this man page is out-of-date, as it hasn't been updated since v. 4.5 as of v. 6.12.3.

Kind regards,
Renato Miceli

FYI: manpages will be rewritten and properly integrated in Abinit 7.

pouillon wrote:FYI: manpages will be rewritten and properly integrated in Abinit 7.

Hi Yann,

when is Abinit 7 planned to be released?

Kind regards,
Renato Miceli

October or November this year:

http://www.abinit.org/developers/abinit ... -of-merges

pouillon wrote:October or November this year:

http://www.abinit.org/developers/abinit ... -of-merges

Thank you, Yann. Looking forward to it!

Kind regards,
Renato Miceli

Hi Yann,

first, thank you very much for releasing Abinit 7.0.3. This version certainly brings very interesting features and fixes! Thanks!

In the meantime, I realized that Abinit's manpage has not changed since version 6.12.3. I really appreciate if you could keep me informed about your future plans for the manpages. Could you let me know when we should expect any updates?

I understand this is low priority. My idea is just to clarify the next steps to our local Abinit users.
Thank you in advance for your time and patience!

Kind regards,
Renato Miceli

I've scheduled the improvement of manpages for version 7.1. If I'm not able to achieve it, I'll reschedule it for a little coding party a few of us are having in April. In the worst case, this will be available in May 2013. In the best case, in January 2013.

Well, the current funding situation in Spain has brought me to other priorities. I'll put it back to my todo list and see what I can do to improve the manpages.

No problem, Yann.

I reckon fixing the build system to publish the manpages under the likes of share/man/man1/ should be simple to perform.
Then they need to be updated but this often takes longer.

Please let me know when the improvements are underway.

Man pages should already be correctly installed in the upcoming 7.8 version of Abinit. If this is not the case yet, everything will be fixed for Abinit 8.0, expected by the end of the year, including the missing man pages.

I'm currently exploring how to have the man pages maintained on the upcoming Abinit Wiki --- which is based on Dokuwiki --- and then transferred automatically to the abinit-doc source package at each release. I already have a good idea of the workflow if I use Pandoc, but I still neeed to decide which intermediate format will be the best to get automatic validation and rendering of the pages. Any opinion on this will be gladly welcome.