The meson build system focuses on speed an ease of use,
which helps speeding up the software development.

Publish documentation on GitLab pages as meson does not embed generated
documentation in distribution tarballs. Pages URL:

    https://gnome.pages.gitlab.gnome.org/libgudev/libgudev

Until developer.gnome.org has a good way to integrate with meson, link
to our own deployment of the docs, generated by the CI.

Closes: #6

Which matches the string representation of a "bool" as used in module
parameters:
"
Standard types are:
[...]
 *  bool: a bool, values 0/1, y/n, Y/N.
"

See https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/tree/include/linux/moduleparam.h#n123

sysfs attributes which contain text will almost always contain a '\n' at
the end so that they can be cat'ed cleanly from the shell.

Fix g_udev_device_get_sysfs_attr_as_boolean to take this into account by
cutting off the string before the first '\n' if it is present.

Closes: #7

We weren't supposed to change the strings recognised as booleans, which
we only documented and didn't actually implement.

The behaviour was changed in commit e186dac0, but the documentation
wasn't updated.

The changes made haphazardly in e186dac0 and 31e31d52 were documented
for _sysfs_attr_as_boolean_uncached() but not implemented.

In the meson port, the package name was changed from 'libgudev' to
'gudev'. Rename the meson project, and fix the 'package_name' to match
the short name to avoid 'liblibgudev' names.

Fixes: 334f31b3

And convert it to MarkDown.

@filename@ writes the full path to the generated file,
which can vary in CI systems and make outputs non-reproducible.

Currently, the volative qualification is not needed here,
it is a historical artifact

Compiler output:
In file included from /usr/include/glib-2.0/glib/gthread.h:32,
                 from /usr/include/glib-2.0/glib/gasyncqueue.h:32,
                 from /usr/include/glib-2.0/glib.h:32,
                 from /usr/include/glib-2.0/gobject/gbinding.h:28,
                 from /usr/include/glib-2.0/glib-object.h:22,
                 from ../gudev/gudevenums.h:14,
                 from ../gudev/gudev.h:11,
                 from gudev/gudevenumtypes.c:4:
gudev/gudevenumtypes.c: In function 'g_udev_device_type_get_type':
/usr/include/glib-2.0/glib/gatomic.h:117:5: warning: argument 2 of '__atomic_load' discards 'volatile' qualifier [-Wincompatible-pointer-types]
  117 |     __atomic_load (gapg_temp_atomic, &gapg_temp_newval, __ATOMIC_SEQ_CST); \
      |     ^~~~~~~~~~~~~
/usr/include/glib-2.0/glib/gthread.h:260:7: note: in expansion of macro 'g_atomic_pointer_get'
  260 |     (!g_atomic_pointer_get (location) &&                             \
      |       ^~~~~~~~~~~~~~~~~~~~
gudev/gudevenumtypes.c:11:7: note: in expansion of macro 'g_once_init_enter'
   11 |   if (g_once_init_enter (&g_define_type_id__volatile))
      |       ^~~~~~~~~~~~~~~~~

All the functions parsing double values from sysfs were using strtod to
parse the values instead of g_ascii_strtod() which forces C locale
parsing. All the kernel values use C locale formatted doubles, so use
g_ascii_strtod().