Converted NEWS.md to Markdown.

Author: mvidner

NEWS.md

@@ -1,32 +1,31 @@
-= Ruby D-Bus NEWS
+# Ruby D-Bus NEWS
 
-Note about bug numbers:
- Ticket#1 - https://trac.luon.net/ruby-dbus/ticket/1
- Issue#1  - http://github.com/mvidner/ruby-dbus/issues#issue/1
- bnc#1    - https://bugzilla.novell.com/show_bug.cgi?id=1
-
-== Unreleased
+## Unreleased
 
 Requirements:
  * Introduced RuboCop to keep a consistent coding style.
  * Replaced Gemfile.ci with a regular Gemfile.
 
-== Ruby D-Bus 0.12.0 - 2016-09-12
+## Ruby D-Bus 0.12.0 - 2016-09-12
 
 API:
  * Added proxy objects whose methods return single values instead of arrays
-   (use Service#[] instead of Service#object; Issue#30).
+   (use Service#[] instead of Service#object; [#30][]).
 
 Requirements:
  * Require ruby 2.0.0, stopped supporting 1.9.3.
 
-== Ruby D-Bus 0.11.2 - 2016-09-11
+[#30]: http://github.com/mvidner/ruby-dbus/issue/30
+
+## Ruby D-Bus 0.11.2 - 2016-09-11
 
 Bug fixes:
  * Fixed reading a quoted session bus address, as written by dbus-1.10.10
-   (Yasuhiro Asaka)
+   ([#62][], Yasuhiro Asaka)
+
+[#62]: https://github.com/mvidner/ruby-dbus/pull/62
 
-== Ruby D-Bus 0.11.1 - 2016-05-12
+## Ruby D-Bus 0.11.1 - 2016-05-12
 
 Bug fixes:
  * Fix default path finding on FreeBSD (Greg)
@@ -35,50 +34,59 @@ Bug fixes:
 Requirements:
  * made tests compatible with RSpec 3
 
-== Ruby D-Bus 0.11.0 - 2014-02-17
+## Ruby D-Bus 0.11.0 - 2014-02-17
 
 API:
  * Connection: split off MessageQueue, marked other methods as private.
 
 Requirements:
  * converted tests to RSpec, rather mechanically for now
 
-== Ruby D-Bus 0.10.0 - 2014-01-10
+## Ruby D-Bus 0.10.0 - 2014-01-10
 
 Bug fixes:
  * fixed "Interfaces added with singleton_class.instance_eval aren't
-   exported" (Issue#22, by miaoufkirsh)
+   exported" ([#22][], by miaoufkirsh)
 
 Requirements:
  * Require ruby 1.9.3, stopped supporting 1.8.7.
 
-== Ruby D-Bus 0.9.3 - 2014-01-02
+[#22]: https://github.com/mvidner/ruby-dbus/issue/22
+
+## Ruby D-Bus 0.9.3 - 2014-01-02
 
 Bug fixes:
- * re-added COPYING, NEWS, README.md to the gem (Issue#47,
+ * re-added COPYING, NEWS, README.md to the gem ([#47][],
    by Cédric Boutillier)
 
 Packaging:
  * use packaging_rake_tasks
 
-== Ruby D-Bus 0.9.2 - 2013-05-08
+[#47]: https://github.com/mvidner/ruby-dbus/issue/47
+
+## Ruby D-Bus 0.9.2 - 2013-05-08
 
 Features:
  * Ruby strings can be passed where byte arrays ("ay") are expected 
-   (Issue#40, by Jesper B. Rosenkilde)
+   ([#40][], by Jesper B. Rosenkilde)
 
 Bug fixes:
- * Fixed accessing ModemManager properties (Issue#41, reported
+ * Fixed accessing ModemManager properties ([#41][], reported
    by Ernest Bursa). MM introspection produces two elements
    for a single interface; merge them.
 
-== Ruby D-Bus 0.9.1 - 2013-04-23
+[#40]: https://github.com/mvidner/ruby-dbus/issue/40
+[#41]: https://github.com/mvidner/ruby-dbus/issue/41
+
+## Ruby D-Bus 0.9.1 - 2013-04-23
 
 Bug fixes:
  * Prefer /etc/machine-id to /var/lib/dbus/machine-id
-   when DBUS_SESSION_BUS_ADDRESS is unset (Issue#39, by WU Jun).
+   when DBUS_SESSION_BUS_ADDRESS is unset ([#39][], by WU Jun).
+
+[#39]: https://github.com/mvidner/ruby-dbus/issue/39
 
-== Ruby D-Bus 0.9.0 - 2012-11-06
+## Ruby D-Bus 0.9.0 - 2012-11-06
 
 Features:
  * When calling methods, the interface can be left unspecified if unambiguous
@@ -89,131 +97,170 @@ Bug fixes:
  * Introspection attribute "direction" can be omitted
    as allowed by the specification (Noah Meyerhans).
  * ProxyObjectInterface#on_signal no longer needs the "bus" parameter
-   (Issue#31, by Damiano Stoffie)
+   ([#31][], by Damiano Stoffie)
 
-== Ruby D-Bus 0.8.0 - 2012-09-20
+[#31]: https://github.com/mvidner/ruby-dbus/issue/31
+
+## Ruby D-Bus 0.8.0 - 2012-09-20
 
 Features:
- * Add Anonymous authentication (Issue#27, by Walter Brebels).
- * Use Nokogiri for XML parsing when available (Issue#24, by Geoff Youngs).
+ * Add Anonymous authentication ([#27][], by Walter Brebels).
+ * Use Nokogiri for XML parsing when available ([#24][], by Geoff Youngs).
 
 Bug fixes:
- * Use SCM_CREDS authentication only on FreeBSD, not on OpenBSD (Issue#21,
+ * Use SCM_CREDS authentication only on FreeBSD, not on OpenBSD ([#21][],
    reported by Adde Nilsson).
- * Recognize signature "h" (UNIX_FD) used eg. by Upstart (Issue#23,
+ * Recognize signature "h" (UNIX_FD) used eg. by Upstart ([#23][],
    by Bernd Ahlers).
- * Find the session bus also via launchd, on OS X (Issue#20, reported
+ * Find the session bus also via launchd, on OS X ([#20][], reported
    by Paul Sturgess).
 
 Other:
  * Now doing continuous integration with Travis:
      http://travis-ci.org/#!/mvidner/ruby-dbus
 
+[#20]: https://github.com/mvidner/ruby-dbus/issue/20
+[#21]: https://github.com/mvidner/ruby-dbus/issue/21
+[#23]: https://github.com/mvidner/ruby-dbus/issue/23
+[#24]: https://github.com/mvidner/ruby-dbus/issue/24
+[#27]: https://github.com/mvidner/ruby-dbus/issue/27
 
-== Ruby D-Bus 0.7.2 - 2012-04-05
+## Ruby D-Bus 0.7.2 - 2012-04-05
 
 A brown-paper-bag release.
 
 Bug fixes:
  * Fixed "undefined local variable or method `continue'" in
    DBus::Main#run when a service becomes idle (by Ravil Bayramgalin)
 
-== Ruby D-Bus 0.7.1 - 2012-04-04
+## Ruby D-Bus 0.7.1 - 2012-04-04
 
 Bug fixes:
- * Fixed calling asynchronous methods on the default interface (Issue#13,
+ * Fixed calling asynchronous methods on the default interface ([#13][],
    by Eugene Korbut). 
  * Fixed Main#quit to really quit the loop (by Josef Reidinger)
  * Unbundled files from Active Support (by Bohuslav Kabrda)
 
-== Ruby D-Bus 0.7.0 - 2011-07-26
+[#13]: https://github.com/mvidner/ruby-dbus/issue/13
+
+## Ruby D-Bus 0.7.0 - 2011-07-26
 
 Features:
  * Added ASystemBus and ASessionBus, non-singletons useful in tests
    and threads.
 
 Bug fixes:
- * Fixed handling of multibyte strings (Issue#8, by Takayuki YAMAGUCHI).
- * Allow reopening of a dbus_interface declaration (Issue#9, by T. YAMAGUCHI).
- * Fixed ruby-1.9.2 compatibility again (Issue#12).
- * Fixed authentication on BSD (Issue#11, by Jonathan Walker)
+ * Fixed handling of multibyte strings ([#8][], by Takayuki YAMAGUCHI).
+ * Allow reopening of a dbus_interface declaration ([#9][], by T. YAMAGUCHI).
+ * Fixed ruby-1.9.2 compatibility again ([#12][]).
+ * Fixed authentication on BSD ([#11][], by Jonathan Walker)
  * Fixed exiting a nested event loop for synchronous calls
    (reported by Timo Warns).
  * Fixed introspection calls leaking reply handlers.
  * "rake test" now works, doing what was called "rake env:test"
 
-== Ruby D-Bus 0.6.0 - 2010-12-11
+[#8]: https://github.com/mvidner/ruby-dbus/issue/8
+[#9]: https://github.com/mvidner/ruby-dbus/issue/9
+[#11]: https://github.com/mvidner/ruby-dbus/issue/11
+[#12]: https://github.com/mvidner/ruby-dbus/issue/12
+
+## Ruby D-Bus 0.6.0 - 2010-12-11
 
 Features:
- * Clients can access properties conveniently (Ticket#28).
+ * Clients can access properties conveniently ([T#28][]).
 
 Bug fixes:
- * Service won't crash whan handling an unknown method or interface (Ticket#31).
+ * Service won't crash whan handling an unknown method or interface ([T#31][]).
  * Don't send an invalid error name when it originates from a NameError.
 
-== Ruby D-Bus 0.5.0 - 2010-11-07
+[T#28]: https://trac.luon.net/ruby-dbus/ticket/28
+[T#31]: https://trac.luon.net/ruby-dbus/ticket/31
+
+## Ruby D-Bus 0.5.0 - 2010-11-07
 
 Features:
  * Better binding of Ruby Exceptions to D-Bus Errors.
- * Converted the package to a Gem (Issue#6).
+ * Converted the package to a Gem ([#6][]).
  * Converted the tutorial from Webgen to Markdown.
 
 Bug fixes:
  * Don't pass file descriptors to subprocesses.
- * Fixed InterfaceElement::validate_name (Ticket#38, by Herwin Weststrate).
- * Fixed a typo in InvalidDestinationName description (Ticket#40).
+ * Fixed InterfaceElement::validate_name ([T#38][], by Herwin Weststrate).
+ * Fixed a typo in InvalidDestinationName description ([T#40][]).
+
+[#6]: https://github.com/mvidner/ruby-dbus/issue/6
+[T#38]: https://trac.luon.net/ruby-dbus/ticket/38
+[T#40]: https://trac.luon.net/ruby-dbus/ticket/40
 
-== Ruby D-Bus 0.4.0 - 2010-08-20
+## Ruby D-Bus 0.4.0 - 2010-08-20
 
 Features:
  * TCP transport (by pangdudu)
  * Enabled test code coverage report (rcov)
 
 Bug fixes:
- * Classes should not share all interfaces (Ticket#36/Issue#5)
- * Ruby 1.9 compatibility (Ticket#37, by Myra Nelson)
+ * Classes should not share all interfaces ([T#36][]/[#5][])
+ * Ruby 1.9 compatibility ([T#37][], by Myra Nelson)
 
-== Ruby D-Bus 0.3.1 - 2010-07-22
+[#5]: https://github.com/mvidner/ruby-dbus/issue/5
+[T#36]: https://trac.luon.net/ruby-dbus/ticket/36
+[T#37]: https://trac.luon.net/ruby-dbus/ticket/37
+
+## Ruby D-Bus 0.3.1 - 2010-07-22
 
 Bug fixes:
- * Many on_signal could cause DBus.Error.LimitsExceeded bnc#617350).
+ * Many on_signal could cause DBus.Error.LimitsExceeded [bsc#617350][]).
    Don't add a match rule that already exists, enable removing match
    rules. Now only one handler for a rule is called (but it is possible
    for one signal to match more rules). This reverts the half-fix done
-   to fix Issue#3
+   to fix [#3][]
  * Re-added InterfaceElement#add_param for compatibility.
  * Handle more ways which tell us that a bus connection has died.
 
-== Ruby D-Bus 0.3.0 - 2010-03-28
+[#3]: https://github.com/mvidner/ruby-dbus/issue/3
+[bsc#617350]: https://bugzilla.novell.com/show_bug.cgi?id=617350
+
+## Ruby D-Bus 0.3.0 - 2010-03-28
 
 Bug fixes:
 
  * Fixed "undefined method `get_node' for nil:NilClass"
-   on Ubuntu Karmic (Ticket#34).
- * Get the session bus address even if unset in ENV (Issue#4).
+   on Ubuntu Karmic ([T#34][]).
+ * Get the session bus address even if unset in ENV ([#4][]).
  * Improved exceptions a bit:
    UndefinedInterface, InvalidMethodName, NoMethodError, no RuntimeException
 
  These are by Klaus Kaempf:
- * Make the signal dispatcher call all handlers (Issue#3).
- * Run on Ruby < 1.8.7 (Issue#2).
- * Avoid needless DBus::IncompleteBufferException (Ticket#33).
- * Don't ignore DBus Errors in request_service, raise them (Ticket#32).
+ * Make the signal dispatcher call all handlers ([#3][]).
+ * Run on Ruby < 1.8.7 ([#2][]).
+ * Avoid needless DBus::IncompleteBufferException ([T#33][]).
+ * Don't ignore DBus Errors in request_service, raise them ([T#32][]).
+
+[#2]: https://github.com/mvidner/ruby-dbus/issue/2
+[#3]: https://github.com/mvidner/ruby-dbus/issue/3
+[#4]: https://github.com/mvidner/ruby-dbus/issue/4
+[T#32]: https://trac.luon.net/ruby-dbus/ticket/32
+[T#33]: https://trac.luon.net/ruby-dbus/ticket/33
+[T#34]: https://trac.luon.net/ruby-dbus/ticket/34
 
 Features:
 
  * Automatic signature inference for variants.
  * Introduced FormalParameter where a plain pair had been used.
 
-== Ruby D-Bus 0.2.12 - 2010-01-24
+## Ruby D-Bus 0.2.12 - 2010-01-24
 
 Bug fixes:
 
  * Fixed a long-standing bug where a service activated by the bus
    would fail with "undefined method `get_node' for nil:NilClass"
-   (Tickets#25 and #29).
+   ([T#25][] and [T#29][]).
 
-== Ruby D-Bus 0.2.11 - 2009-11-12
+[T#25]: https://trac.luon.net/ruby-dbus/ticket/25
+[T#29]: https://trac.luon.net/ruby-dbus/ticket/29
+
+
+## Ruby D-Bus 0.2.11 - 2009-11-12
 
 Features:
 
@@ -222,37 +269,43 @@ Features:
 Bug fixes:
 
  * Return org.freedesktop.DBus.Error.UnknownObject instead of crashing
-   (Ticket#31).
+   ([T#31][]).
  * Rescue exceptions in dbus_methods and reply with DBus errors instead of
    crashing (da1l6).
  * Better exception messages when sending nil, or mismatched structs.
  * Call mktemp without --tmpdir, to build on older distros.
 
-== Ruby D-Bus 0.2.10 - 2009-09-10
+[T#31]: https://trac.luon.net/ruby-dbus/ticket/31
+
+## Ruby D-Bus 0.2.10 - 2009-09-10
 
 Bug fixes:
 
  * DBus::Service.exists? fixed (Murat Demirten).
  * Ruby 1.9 fixes (Jedediah Smith).
- * Fixed an endless sleep in DBus::Main.run (bnc#537401).
- * Added details to PacketMarshaller exceptions (bnc#538050).
+ * Fixed an endless sleep in DBus::Main.run ([bsc#537401][]).
+ * Added details to PacketMarshaller exceptions ([bsc#538050][]).
 
-(bnc#FOO refers to https://bugzilla.novell.com/show_bug.cgi?id=FOO )
+[bsc#537401]: https://bugzilla.novell.com/show_bug.cgi?id=537401
+[bsc#538050]: https://bugzilla.novell.com/show_bug.cgi?id=538050
 
-== Ruby D-Bus "I'm not dead" 0.2.9 - 2009-08-26
+## Ruby D-Bus "I'm not dead" 0.2.9 - 2009-08-26
 
 Thank you to Paul and Arnaud for starting the project. I, Martin
 Vidner, am continuing with it on GitHub.
 
  * Fixed passing an array through a variant (no ticket).
- * Fixed marshalling "av" (Ticket #30).
- * Fixed variant alignment (Ticket #27).
+ * Fixed marshalling "av" ([T#30][]).
+ * Fixed variant alignment ([T#27][]).
  * Added DBus::Main.quit.
  * Mention the DBus interface in a NameError for an unknown method.
  * Fixed ruby-1.9 "warning: default `to_a' will be obsolete".
  * Added Rakefile and gemspec.
 
-== Ruby D-Bus "Thanks for all the fish" 0.2.1 - 2007-12-29
+[T#27]: https://trac.luon.net/ruby-dbus/ticket/27
+[T#30]: https://trac.luon.net/ruby-dbus/ticket/30
+
+## Ruby D-Bus "Thanks for all the fish" 0.2.1 - 2007-12-29
 
 More bugfixes, mostly supplied by users supplying us with patches.  Thanks!
 
@@ -265,19 +318,19 @@ More bugfixes, mostly supplied by users supplying us with patches.  Thanks!
  * Some polish (removed debug output, solved unnecessary warnings).
  * Documentation updates, example fixes and updates.
 
-== Ruby D-Bus "Almost live from DebConf 7" 0.2.0 - 2007-06-02
+## Ruby D-Bus "Almost live from DebConf 7" 0.2.0 - 2007-06-02
 
 Again a bugfix release, also meant to be the public release
 for exploratory purposes. New in 0.2.0:
 
  * Complete tutorial revamp.
  * Relicensed to the LGPL.
 
-== Ruby D-Bus "Release Often" 0.1.1 - 2007-04-23
+## Ruby D-Bus "Release Often" 0.1.1 - 2007-04-23
 
 Bugfix release.  Fixes hardcoded string for requesting bus names,
 found by Rudi Cilibrasi.
 
-== Ruby D-Bus "Happy Birthday Paul" 0.1.0 - 2007-04-17
+## Ruby D-Bus "Happy Birthday Paul" 0.1.0 - 2007-04-17
 
 First release. Supports most of D-Bus' features.