Fix incorrect doxygen comment for srd_decoder_list().

This fixes bug #378.

All PDs: Minor whitespace and consistency fixes.

 - No newlines at the end of files.
 - No trailing ';' characters.
 - Comparison with None: Use 'is None' or 'is not None'.
 - Comparison with True/False: Use 'if cond:' or 'if not cond:'.
 - Various minor whitespace fixes.

uart/i2cfilter: Don't check multiple-choice options.

For options which only have a limited set of valid values, we don't need
to check (in the PD) whether a valid value was supplied, since the backend
can do that for us.

Various PDs: Minor consistency fixes.

(Consistently use single-quotes for all Python strings everywhere)

Various PDs: Throw SamplerateError instead of Exception.

Also, use the "if not self.samplerate" form, which catches both the case
where self.samplerate is None, as well as the case where it is 0.

All PDs: Drop unneeded exceptions.

In all current PDs it is not necessary to raise an exception upon
invalid states (of the PD's state machine), since we can guarantee that
no such invalid state can ever be reached in these PDs.

Add nRF24L01(+) protocol decoder.

spi: Fix order of MISO/MOSI data items.

pdtest: Use new exception output.

Make exception output more predictable.

Remove dependency on Python.h from public API header

This prevents Python.h from being included into client code, where
it can mess things up by e.g. redefining _POSIX_C_SOURCE.

runtc: Fix incorrect include directive

runtc.c used to try to include "../config.h".  This only works when
building in the source tree, otherwise there is no config.h in the
parent directory of runtc.c.  However, the explicit path is
unnecessary since the build directory (whether the same as the source
directory or not) will always be added to the include path.

srd_decoder_load_all_path: Support zipimport paths

srd_decoder_load() works perfectly with decoders stored inside zip files.
However, srd_decoder_load_all{_path,}() did not, because it assumed that
normal directory listings can be used to enumerate decoders, which is not
the case for zipped decoders.  Fix this by providing a fallback based on
the zipimporter Python class.

spi: Add coverage tests for all exceptions.

spi: Add coverage tests for all mosi/miso and lsb/msb combinations.

spi: Refactor for more coverage, and remove dead code.

runtc: PD option value is a GVariant, not string.

This is still broken: it needs to properly check the expected type of
the option, not just blindly assume G_VARIANT_TYPE_STRING.

pdtest: Generate report regardless of verbose mode.

edid: Add another test, covering more code in the PD.

pdtest: Generate a report listing missed lines across the whole PD.

i2c: Generate proper exception for missing samplerate, and test for it.

Also remove some dead code.

pdtest/runtc: Support for output type 'exception'.

The match value should be the name of the exception thrown, e.g.
AttributeError, IndexError or even a custom exception defined in
the protocol decoder, such as SamplerateError.

do not add check to common cflags/libs

Only the unittests use these flags, so don't go linking them in for
the main library too.

fix test operator

The == operator is not in POSIX.

runtc.c: Fix compiler warning

c was of type char, while getopt returns an int. This
caused a compiler warning during build.

libsigrokdecode: Fix make -j issue with build_runtc

The build of runtc caused issues with make -j as runtc
was attempted to be linked with libsigrokdecode before
libsigrokdecode was linked. Using LDADD to insert
libsigrokdecode ensures that it links before runtc,
ensuring the build completes correctly.

Add python as a pkg-config dependency

The current libsigrokdecode build passes the python
CPPFLAGS and LDFLAGS directly into libsigrokdecode.pc.in.
This leads to issues while cross-compiling as while using
PKG_CONFIG_SYSROOT_DIR, there is a chance of the prefix
being duplicated. We now, while detecting the installation
of python (cross or normal), add a dependency for the
module name in the pkgconfig file (from configure.ac).

configure.ac: Bump package version to 0.3.0.

configure.ac: Bump libtool/library version from 1:0:0 to 2:0:0.

The libtool current:revision:age numbers change from 1:0:0 to 2:0:0.

Details:
http://www.gnu.org/software/libtool/manual/libtool.html#Updating-version-info

This changes the library filename (e.g. on Linux) from
libsigrokdecode.so.1.0.0 to libsigrokdecode.so.2.0.0, the SONAME (+symlink)
becomes libsigrokdecode.so.2.

Bump libsigrok (optional) dependency to 0.3.0.

NEWS: Add list of user-visible changes so far.

Makefile.am: Add HACKING to the tarball.

Only load and use PDs of API version 2.

Decoders that implement any other PD API version are per definition not
compatible and cannot work with this library version.

README: Document python3-coverage requirement for tests.

Fix 'make install' on OSes where 'python3' doesn't exist.

Sometimes the Python 3 executable is called just 'python3', sometimes
it is called 'python3.4' and so on. Handle all cases transparently for
the user.

Before:

  $ make install
  /usr/bin/env: python3: No such file or directory

After:

  $ make install
  python3.4 ./tools/install-decoders -i ./decoders -o [...]
  Installing 36 protocol decoders:
  [...]

HACKING: Update to current conventions.

(mostly copied from libsigrok, which normally has the same conventions)

Mark some variables more consistently as SRD_PRIV.

log.c: Avoid using the same name for a variable and enum.

Update a few Doxygen @since tags.

libsigrokdecode.h: Give type names to all enumerations.

This matches the libsigrok conventions, and will be required (or
at least nice to have) for libsigrokdecode language bindings later.

tools/install-decoders: Minor consistency fix.

Move srd_check_init() to decoder.c and make it static.

The function srd_check_init() is only used in decoder.c.

Make 'pd_list' static, it's only used in one file.

Make the srd_Decoder type private.

It's not public API and is not used (nor should it be used) by any frontends.

srd.c: Fix typo to avoid Doxygen output for srd_check_init().

Doxygen: Don't parse anything in tests/ or doxy/.

None of that is API-relevant.

doxygen: Updated Doxyfile to doxygen 1.8.6.

Don't define names ending with _t (POSIX reserved).

Avoid defining any names ending in _t, those are generally reserved
for POSIX usage. For details see:

http://pubs.opengroup.org/onlinepubs/007904975/functions/xsh_chap02_02.html
http://www.gnu.org/software/libc/manual/html_node/Reserved-Names.html

edid: s/annotation type/annotation class/.

tests/check_session.c: Use UINT64_MAX.

Detect Python 3.4 if not installed as "python3".

instance.c: s/probe/channel/.

All PDs: More consistent OUTPUT_PYTHON format docs.

sdcard_spi: Avoid duplicate keys in a Python dict.

This fixes bug #191.

All PDs: Bump api_version to 2.

Older libsigrokdecode versions are no longer able to use the current
versions of the PDs (various changes in syntax etc).

All PDs: Drop some unneeded comments.

nunchuk: Fix PD to become usable in GUIs.

 - Provide proper annotation classes and annotation rows.
 - Emit bit-exact annotations for some registers.
 - Output short and long annotations (for use when zooming).
 - Various minor fixes.

This fixes bug #344.

debug: Log unitsize when configuring channel map.

.gitignore: Add test-suite.log.

Rename 'probe' to 'channel' everywhere.

Variables of type 'struct srd_channel *' are consistently named 'pdch' to
make them easily distinguishable from libsigrok's 'struct sr_channel *'
variables that are consistently named 'ch'.

z80: Fix incorrect license field.

Switch to a non-recursive automake setup.

(fewer files, less clutter)

README: Update build dependencies list.

configure.ac: Clearly mark required and optional libs.

Also, drop printing of the detected Python CPPFLAGS/LDFLAGS, not really
needed since it's available in 'make V=1' output as well (and we don't print
it for other libs either).

Bump minimum Python version to 3.2

We use some functions specific to 3.1, but every distribution appears
to be at 3.2.x already anyway.

pdtest: Add support for code coverage.

runtc: Add list of missed lines to coverage output.

usb_packet: Fix an incorrect index.

usb_packet: Provide better short/long annotations.

usb_signalling: Make each symbol an annotation class.

usb_signalling: Provide better short/long annotations.

Add support for code coverage of used decoder modules.

Bring various test output files up to date.

pdtest: Small fix.

Various PDs: Minor option related fixes.

Various PDs: Drop currently unsupported probes in stacked PDs.

At the moment we don't yet support PDs which take both input from
another PD (which they're stacked on top of) and from one or more
logic inputs/pins.

This will be supported later on, and at that time we'll bring back
these changes.

can: Make sample_point a float option.

This allows users to set values like 70.5% or such.

Fix enumeration of option values.

Fixed g_variant_get_double copy-paste error

ir_nec: Update to recent PD API changes.

ir_nec: Add support for higher-level remote control annotations.

ir_nec: Addresses and commands are transmitted LSB-first.

ir_nec: Add support for more fields.

Also show the AGC field(s) and pauses, the stop bit, and the individual
address / address# and command / command# fields.

ir_nec: Drop some unneeded options.

The timing of the protocol is not really configurable, valid data in
this protocol must always adhere to the same timing parameters, making them
configurable should not be needed.

Also: Only check for the "interesting" edges and simplify the code a bit.

Rename 'ir_nec6122' PD to 'ir_nec', minor fixes and simplifications.

This IR protocol is commonly referred to as "the NEC protocol", and can be
generated by various means (not only via the NEC µPD6121/µPD6122 ICs).

Drop some unneeded variables and fix/simplify the code a bit.

Add NEC IR protocol decoder.

Probes, optional probes and annotations now take a tuple.

Annotation entries also consist of a tuple, not a list.

ir_rc5: Change PD options to be a tuple of dictionaries.

Remove unused probes and options

Change PD options to be a tuple of dictionaries.

Each option consists of a dictionary with the following keys:

  id      The option id, which is passed in when setting a value.
  desc    A description of the option, suitable for display.
  def     The default value for this option.
  values  (optional) If present, a tuple containing values the option
          may take. They must be of the same type as the default.

Valid types for the options are UTF-8-encoded strings, integers, and
floating point values.

onewire_link: Replaced us with µs

ir_rc5: Fix incorrect bit length of RC-5 packets.

All RC-5 packets are 14 bits long.

ir_rc5: Don't throw exception upon invalid edge distances.

Instead, reset the state machine and continue with the rest of the data.

ir_rc5: Only determine edge type once.

Add initial RC-5 IR protocol decoder.

z80: Use methods directly as state values.

z80: Display not-taken conditional calls correctly.

z80: Fix display of read/modify/write instructions.

z80: Shorten annotation ID 'warning' to 'warn'.

z80: Output jump offsets relative to instruction start.

Most assemblers recognize the symbol $ for the address of the
current instruction. Make use of this to output relative jump
instructions using the $[+-]offset syntax, with offset being
the displacement minus the instruction length.