# GMT 6 install complete documentation fails

**URL:** <https://forum.generic-mapping-tools.org/t/gmt-6-install-complete-documentation-fails/251>\
**Category:** Q&A\
**Created:** [February 18, 2020, 10:43am UTC](https://forum.generic-mapping-tools.org/t/gmt-6-install-complete-documentation-fails/251 "2020-02-18T10:43:29Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![HDenker](https://avatars.discourse-cdn.com/v4/letter/h/f4b2a3/32.png) [@HDenker](https://forum.generic-mapping-tools.org/u/HDenker)\
**Post date:** [February 18, 2020, 10:43am UTC](https://forum.generic-mapping-tools.org/t/gmt-6-install-complete-documentation-fails/251/1 "2020-02-18T10:43:29Z")

</div>

Dear all,

I have problems installing the complete documentation for GMT 6 (I only get a few man pages: gmt, gmt-config, gmt\_shell\_functions.sh, gmtswitch, isogmt), but the rest is missing. I tried “set (GMT\_INSTALL\_EXTERNAL\_DOC/MAN ON)”, but had no success.

I also executed “cmake --build . --target docs\_man/html” and got “WARNING: html\_static\_path entry ‘\_source/\_static’ does not exist” - probably this is the reason for the missing man pages?

I am especially interested in a complete set of man pages (but also in the html and pdf documents), if possible, directly from the external GMT server. Perhaps it is just a wrong Setup of ConfigUser.cmake?

Any help on this matter is very much appreciated.

With best regards,  
Heiner Denker  
Leibniz University Hannover

---

<div class="post-metadata">

**Author:** ![seisman](https://yyz1.discourse-cdn.com/flex047/user_avatar/forum.generic-mapping-tools.org/seisman/32/4_2.png) [@seisman](https://forum.generic-mapping-tools.org/u/seisman)\
**Post date:** [February 18, 2020, 8:18pm UTC](https://forum.generic-mapping-tools.org/t/gmt-6-install-complete-documentation-fails/251/2 "2020-02-18T20:18:12Z")

</div>

We decided to drop most man pages and PDF documentation since GMT 6.0.0. See the two issues below for discussions.

> <https://github.com/GenericMappingTools/gmt/issues/1728>
>
> The UNIX man pages seem useless for most users, as now they can access the HTML …version local/remote documentation via \`gmt docs\`. The UNIX man page format is also limited to plain text, preventing us from adding non-text elements (e.g. figures) to the manual.
> 
> Do you think we should drop the UNIX man pages?

> <https://github.com/GenericMappingTools/gmt/issues/805>
>
> PDF documentation is a legacy from the past when we printed stuff. Now it is a …limitation since not everything that can be done in HTML translate to PDF. It also adds bulk to the tarballs, etc.
> 
> The proposals is to remove all vestiges of PDF from the documentation and the CMake/build scripts. Looking for comments from @GenericMappingTools/core here.

---

<div class="post-metadata">

**Author:** ![HDenker](https://avatars.discourse-cdn.com/v4/letter/h/f4b2a3/32.png) [@HDenker](https://forum.generic-mapping-tools.org/u/HDenker)\
**Post date:** [February 19, 2020, 2:13pm UTC](https://forum.generic-mapping-tools.org/t/gmt-6-install-complete-documentation-fails/251/3 "2020-02-19T14:13:29Z")

</div>

Ok, thanks for the clarification. I thought that something went wrong during my installation (because of the warning message from “cmake --build . --target docs\_man/html”).  
Nevertheless, I found it always very convenient to have the full man pages, because I work frequently on a server without Xwindows support. However, of course one can also live with “gmt docs …”.

So I understand that my installation is okay and complete.

Thanks again and best regards,  
Heiner

---

<div class="post-metadata">

**Author:** ![weiji14](https://yyz1.discourse-cdn.com/flex047/user_avatar/forum.generic-mapping-tools.org/weiji14/32/33_2.png) [@weiji14](https://forum.generic-mapping-tools.org/u/weiji14)\
**Post date:** [November 2, 2021, 9:28pm UTC](https://forum.generic-mapping-tools.org/t/gmt-6-install-complete-documentation-fails/251/4 "2021-11-02T21:28:11Z")

</div>

Ping @mdtanker. This is the issue I mentioned on PDF documentation being dropped from GMT. I’ll see if there’s still a way to get the PDF rendered manually for PyGMT (and maybe GMT) since you need to work offline in the field for a few months.

Edit: We’re discussing about building PDF docs for PyGMT at [https://github.com/GenericMappingTools/pygmt/issues/1606](https://github.com/GenericMappingTools/pygmt/issues/1606). Feel free to continue the discussion there.
