meson/docs
Jon Turney 1f5c6d62bf More clearly explain portability issues with linking to a module
Refine #3277

According to what I read on the internet, on OSX, both MH_BUNDLE (module)
and MH_DYLIB (shared library) can be dynamically loaded using dlopen(), but
it is not possible to link against MH_BUNDLE as if they were shared
libraries.

Metion this as an issue in the documentation.

Emitting a warning, and then going on to fail during the build with
mysterious errors in symbolextractor isn't very helpful, so make attempting
this an error on OSX.

Add a test for that.

See also:
https://docstore.mik.ua/orelly/unix3/mac/ch05_03.htm
https://stackoverflow.com/questions/2339679/what-are-the-differences-between-so-and-dylib-on-osx
2018-06-07 12:57:39 +00:00
..
images docs: Expand section on how to install Python3 and Meson 2018-06-03 18:59:24 +00:00
markdown More clearly explain portability issues with linking to a module 2018-06-07 12:57:39 +00:00
theme/extra [fixup]: write documentation 2018-04-09 15:46:06 +02:00
README.md docs: clarify where hotdoc should be run 2017-05-08 20:11:47 -04:00
hotdoc.json Fix web site upload repository. 2017-04-26 22:53:26 +03:00
sitemap.txt Updated version number for new release. 2018-04-23 03:24:26 +03:00

README.md

Building the documentation

  1. Get hotdoc (0.8.9 required)

  2. Run hotdoc in the docs/ directory:

    hotdoc run

Upload

We are using the git-upload hotdoc plugin which basically removes the html pages and replaces with the new content.

You can simply run:

hotdoc run --git-upload-activate