cli: use SR_DF_META_*, support for analog packets

cli: configure.ac: Bump version number to 0.3.1.

cli: Constify a few char *pointers.

cli: Update NEWS in preparation of 0.3.1 the release.

cli: Cosmetic fix for --help output.

cli: Fix compile error.

cli: Make --protocol-decoder-annotations plural.

This option supports (will support) multiple annotations from multiple
PDs, as well as multiple annotation formats per PD, so use plural.

cli: Add -A (alias for --protocol-decoder-annotation).

cli: manpage cosmetics, updates.

sr/srd/cli/gtk: ChangeLog -> MAINTAINERCLEANFILES.

If the (generated) ChangeLog file is marked for DISTCLEANFILES, it'll be
removed whenever "make distclean" is called (and is then gone forever if
you use the tarballs, for example).

cli: Output which file format was autodetected.

document --protocol-decoder-annotation, and note PD stack is optional.

cli: factor out output format setup

main() is now clean.

cli: option to specify which annotation(s) to show

Also factor out PD stack setup, and remove redundant error messages.

cli: stop immediately if SRD PD registration fails

cli: loose string comparison helper

cli: always show G_LOG_LEVEL_CRITICAL messages

cli: cosmetics

cli: halt session if SRD session fails to initialize

cli: only output module or PD goes to stdout, everything else to stderr

cli: removed obsolete debugging, setup for proper stderr logging

cli: no need to specify stacking order if it's the same as the PD list

sr/srd/cli: Fix compiling with Homebrew.

Add ACLOCAL_DIR setting and AM_PROG_AR macro for compiling with Homebrew
under Mac OS X.

Applies essentially the same change to
{libsigrok,libsigrokdecode,sigrok-cli}/{autogen.sh,configure.ac}

It may be that the same fix is needed for the other autogen.sh and/or
configure.ac files, but that hasn't been tested and therefore not in
this commit.

cli: Print required/optional probes info.

When running 'sigrok-cli -a uart' (for example), we now additionally
print which required/optional probes the decoder needs.

cli: -V: Print protocol description upon "-l 3" or higher.

Fix bracket placing

Make it consistent with the rest of the code

Signed-off-by: Thomas Jarosch <redacted>

cli: Generate ChangeLog upon 'make dist'.

cli: New 0.3.0 release.

Document the major user-visible changes in the NEWS file.

cli: Show sr/srd versions determined at run-time.

cli: NEWS: Add 0.1.0/0.2.0 release docs.

cli: Add (almost) empty NEWS file.

sr/srd: Use/fix SR(D)_MAX_NUM_PROBES.

sr: out: Use uint8_t (not char) for buffers.

srd/cli/qt: Some more API consistency renames.

cli: Fix -V/-h output a bit.

Options and their defaults should not be documented there, but rather in
the manpage or such.

sr/cli/gtk/qt: Fix package version numbers / docs.

The next (and first) libsigrok release will be called 0.1.0.

The next (and first) libsigrokdecode release will be called 0.1.0.

The next sigrok-cli release will be called 0.3.0 (as we already had a 0.1
and 0.2 release of sigrok-cli; those did not yet use the libs, though).

sigrok-gtk and sigrok-qt didn't have any releases yet, so their version
numbers are set to 0.1.0.

Also, consistently use three numbers/digits for our version numbers.

sr/cli: s/patternmode/pattern/ in a few places.

srd/cli/qt: s/srd_session_feed/srd_session_send/.

cli: Same order for params in manpage and -h.

cli: manpage: Document -l, -a, and -s.

Also, update list of supporter input/output formats.

cli: Fix/update manpage a bit.

srd/cli/qt:s/decoders/decoder/ for consistency.

sr: Rename -f|--format to -O|--output-format.

This is done for consistency with the -I|--input-format option. We now have:

-i|--input-file
-o|--output-file
-I|--input-format
-O|--output-format

sr: Name all callback data 'cb_data'.

sr/cli/gtk/qt: s/hw/driver/ in some places.

sr: s/sr_dev_probe_name/sr_dev_probe_name_set/.

sr/cli/gtk/qt/: s/plugin/driver/.

sr: sr_samplerate_string: Allow 3.15Hz etc. as output.

This is required for some hardware, e.g. ChronoVu LA8, where
33.333333 MHz or 2.439024 MHz are valid samplerates. This is because the
hardware takes a sampleperiod (in nanoseconds) as input, not a
samplerate (in Hz).

sr: No need for dynamic hardware driver registration.

We don't need or allow run-time registration of hardware
drivers/plugins, they're added at compile-time.

cli/gtk/qt: nsis: Better installer filename.

cli: nsis: Hook up to "Add/remove programs".

sr: s/config_set/dev_config_set/.

This functions is per-device-instance, so use dev_ as prefix as with
the other ones.

sr/cli/gtk/qt: s/configuration/config/.

sr/cli/gtk: s/capability/hwcap/.

sr/cli/gtk: A few more s/instance/inst/.

sr/cli/gtk/qt: s/device/dev/ in many places.

Also, a few s/instance/inst/ occurences.

sr: rename all sr_hwplugin(s)_* functions to sr_hw_*

srd: rename public API functions to srd_thing_action format

srd: don't load all protocol decoders unless we really need to.

sr: rename more functions to sr_thing_action format

Also improved the interface to find capabilities in a hardware plugin.

sr: rename hwplugin functions to sr_thing_action format

sr: rename all sr_device_* functions to sr_dev_*

sr: more API cleanup and documentation

srd: extra module path can now optionally be passed to srd_init()

Also environment variable SIGROKDECODE_DIR, if present, is prepended
to the module path.

Rename 'void *' callback parameters to 'user_data'.

This is better, both for consistency reasons, and also because 'data' is
a bit too generic and might be confusing, especially since we have other
'data' fields in the code in various places.

srd: Every callback should have a 'void *' parameter.

This is required in various situations and for various lib users,
especially so GUIs which might want to pass specific info via this
mechanism.

Use g_try_malloc/g_free/g_strdup consistently.

Avoid plain malloc()/free() in sr/srd, especially in the API calls.
Also avoid g_malloc*() in favor of g_try_malloc*().

Use g_strdup() instead of strdup() so that we can use g_free()
consistently everywhere.

Exceptions: Stuff that is allocated via other libs (not using glib),
should also be properly free'd using the respective free-ing function
(instead of g_free()). Examples: Stuff allocated by libusb, libftdi, etc.

Also, use sr_err() instead of sr_warn() for actual errors. sr_warn() is
meant for non-fatal/uncritical warnings.

srd: rename all instance to inst

sr: Implement proper logging framework.

This is pretty much identical to the current libsigrokdecode API/framework.

srd: More consistent log related function names.

Also, fix typos, constify some parameters, add more Doxygen comments.

cli: nsis: Fix copy-paste error.

cli: nsis: Start menu shortcut (opens a "DOS box").

Add missing logo icon files for Windows installers.

nsis: Install missing msys-1.0.dll and msys-z.dll.

Thanks John-Eric Kamps ("MockUp") for testing on a pristine
Windows 7 (64 bit).

nsis: Request admin privileges for Windows Vista and Windows 7.

nsis: One installer file per frontend.

There will be a sigrok-cli-installer-0.1.exe,
sigrok-gtk-installer-0.1.exe, and sigrok-qt-installer-0.1.exe,
for example.

Also, add some more .gitignore entries.

Project-wide consistent naming for #include guards.

Document the naming scheme in HACKING.

sr/cli/gtk: Remove analog left-overs from API.

This will come back in some form or another later, but for now
don't clutter the API with non-working stuff. Removing stuff from APIs
is not possible without breaking the API, adding stuff later is simpler.

autogen.sh: aclocal support for Windows XP/Vista/7.

cli: cleaned up debug output

Add sr_device_get_info

Update/enforce/document our build requirements.

cli: correctly map probes on every instance, not just the last one.

cli: use new PD instance find function

cli: minor code cleanups

cli: when deciding which PD's output to show, use instance id

cli: use , as a separator for PD stacks, like all other options.

cli: if PDs fail, signal a proper session shutdown instead of abort.

cli: minor cleanup

add SR_HWCAP_DEMO_DEVICE capability

cli: configuring SRD probes no longer deletes them from the hash

CLI: use the new per-PD option setting API

CLI: print sample numbers on annotations on log level > 2

CLI: properly feed SRD a sample number with every chunk of data.

cli: manpage: Add sigrok-gtk(1) to "SEE ALSO".

frontends: Check for sr/srd minimum versions.

CLI: when invoked with only -a <pd>, the PD's documentation is shown.

Improve 'longname' PD strings, use in 'sigrok-cli -V'.

cli: Fix left-over ANN/PROTO names.

Stacked protocol decoders implementation.

The DDC decoder takes input from the I2C PD.