onix2 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: 50f126800e100d586d04c08d38dda4ae2848d1f0
+  data.tar.gz: 2d9c6ce7a8af1235618b03bc836939ffa69f822d
+SHA512:
+  metadata.gz: 2e6e5326ef686ed74da30fd453139c0cbbb966fb40a3537d4f6ff18c8901c11945b607ce571f567ecc50a3751466b6da88a49f7cff369a3e88aac72825f91990
+  data.tar.gz: c326ca07e60476dc8b30c2866ae4a01e52f38635c64ba15532ff4f9c5e8e1db80fdf7aab137633e1e657a55b3cb3f6d8e4006b3e03435a7cc36f4c61620b377f

data/CHANGELOG

@@ -0,0 +1,209 @@
+v1.0.0 (4th December 2014)
+- Rename ONIX to ONIX2
+- Add SalesRight to Product
+- Remove Normaliser
+
+v0.9.5 (28th December 2012)
+- Bugfix: AudienceRangeValue can be non-numeric
+
+v0.9.4 (24th April 2012)
+- Upgrade roxml dependency
+- expand APAProduct to allow the nett price to be set
+
+v0.9.3 (8th  November 2011)
+- Fix ordering of elements within thew Price composite
+
+v0.9.2 (7th November 2011)
+- add basic support for setting and retrieving discount codes on prices
+
+v0.9.1 (5th September 2011)
+- relax activesupport dependency to work with rails 3 or 3.1
+
+v0.9.0 (14th April 2011)
+- switch back to the vanilla roxml gem. Ben is maintaining it again and
+  he has merged in my bug fixes
+- clarify comments explaining encoding behaviour
+- Add options hash to ONIX2::Reader. Only option at this stage is :encoding,
+  which allows the user to override the assumed encoding of the input XML
+- API change, so new minor version
+
+v0.8.5 (21st December 2010)
+- update packaging - use bundler and rspec 2.x
+- support normalising short tag files that include HTML tags
+
+v0.8.4 (18th October 2010)
+- some small fixes to xml names from Tim
+- make all code lists available via the ONIX2::Lists class
+
+v0.8.3 (9th September 2010)
+- Fix for race condition in ONIX2::Normaliser
+  - thanks to pixelvixen for reporting
+- force roxml to be 3.1.6 or higher. Earlier versions misbehaved when monkey
+  patching nokogiri
+
+v0.8.2 (6th May 2010)
+- fix APAProduct#series and APAProduct#series=
+
+v0.8.1 (5th January 2010)
+- Use nokogiri's support for transparent entity conversion when reading an ONIX file
+- Removed entity replacement from ONIX2::Normaliser
+  - the external dependency on sed made me uncomfortable, and it wasn't really
+    necessary now that nokogiri can do it for us
+- Removed utf-8 normalisation from ONIX2::Normaliser
+  - nokogiri also handles this really cleanly and transparently. Regardless of
+    the source file encoding, Nokogiri::Reader returns utf-8 encoded data
+- Add the release attribute to files we generate
+  - it's optional in 2.1, but mandatory in 3.0. As we start to see 3.0 files in the
+    wild it will help to have a rapid way to distinguish between them
+- Add ONIX2::Reader#release - to detect the release version of files we read in
+
+v0.8.0 (31st October 2009)
+- Replace LibXML dependency with Nokogiri. Nokogiri is under active development, has
+  a responsive maintainer and is significantly more stable
+- Switch to ROXML 3.x
+  - roxml also switched from libxml to nokogiri
+  - roxml removed deprecated parts of it's API
+  - should now avoid various conflicts with mongrel
+- Ensure APAProduct#price returns the first product price and ignores
+  the price type
+
+v0.7.8 (19th October 2009)
+- add support for additional elements (mostly series and audience related)
+  - thanks tim
+
+v0.7.7 (1st October 2009)
+- optimise sed usage in ONIX2::Normaliser. *huge* speed improvement on
+  large files.
+
+v0.7.6 (21st September 2009)
+- provide access to the PackQuantity element
+
+v0.7.5 (8th September 2009)
+- Don't raise an exception on malformed dates when reading files
+
+v0.7.4 (2nd September 2009)
+- Expand ONIX2::Normaliser
+  - strip control chars
+  - add encoding declaration to valid utf-8 files that aren't declared
+    as such
+
+v0.7.3 (19th August 2009)
+- Switch from java to xsltproc to convert short tag ONIX files
+  to reference tags
+
+v0.7.2 (19th August 2009)
+- Added ONIX2::Normaliser class
+  - for normalising various ONIX files into a form that makes them easy
+    to process. Shouldn't be necesary to pre-process files like this, but
+    I'm sick of trying to wrestle the libxml ruby bindings
+
+v0.7.1 (24th June 2009)
+- Small tweak to ordering of elements in the Product group
+
+v0.7.0 (17th June 2009)
+- try using LibXML for reader again
+  - retrieving the ONIX version of the input file is currently disabled, as
+    that seems to be the source of our instability
+- Various Ruby 1.9 compatability tweaks
+  - add source file coding declarations. All source files are UTF-8
+  - ONIX2::Reader ensures all input data is converted to UTF-8
+  - the ROXML based objects seem to forget the encoding when they're marshalled,
+    so force string based attributes *back* to UTF-8
+
+v0.6.7 (Unreleased)
+- add some accessors to the Title composite
+
+v0.6.6 (Unreleased)
+- Forget the S on an element name
+
+v0.6.5 (Unreleased)
+- Ruby 1.9 compat
+
+v0.6.4 (Unreleased)
+- Add APAProduct#price
+
+v0.6.3(Unreleased)
+- Bump ROXML dependency to 2.5.3 to get libxml-ruby 1.1.3 compatibility
+
+v0.6.2 (Unreleased)
+- Fix a small typo in APAProduct
+
+v0.6.1 (Unreleased)
+- Stopped using LibXMLs Reader class as the basis for our reader.
+  - We were getting too many segfaults (even 1 is too many!)
+  - until we resolve it, reverted to manual string parsing
+  - This is a fairly major regression of functionality. For 99% of files
+    it won't matter, but for some corner cases it will. ie UTF-16 encoded
+    files
+  - Will also be noticeably slower
+  - Hopefully only a short term fix, until I work out what is going on with
+    libxml
+
+v0.6.0 (18th March 2009)
+- remove use of threads in ONIX2::Reader
+  - a producer/consumer pattern was useful in the REXML stream parsing days, but
+    now LibXML's Reader binding provides a better alternative
+  - API left unchanged, this was all under the hood
+- bump required ROXML version to 2.5.2
+
+v0.5.1 (4th March 2009)
+- Fix a single letter typo
+
+v0.5 (2nd March 2009)
+- Switch ROXML dependency from a patched version to vanilla
+  - Vanilla ROXML now has all the features we need
+  - This change should be transparent to ONIX gem users
+
+v0.4.7 (9th December 2008)
+- Contributor sub elements should match the order specified in the DTD
+
+v0.4.6 (2nd December 2008)
+- 2 new accessors on the contributor class - bio and corporate name
+
+v0.4.5 (21st November 2008)
+- APAProduct wrapper should generate valid MediaFile composites
+
+v0.4.4 (19th November 2008)
+- Added support for more elements from MarketRepresentation
+
+v0.4.3 (11th November 2008)
+- Added support for AgentName and MarketPublishingStatus
+
+v0.4.2 (1st November 2008)
+- Remove final remnants of REXML code
+- Minor reordering of elements to match DTD
+
+v0.4.1 (UNRELEASED)
+- Added accessors to various product measurements. Height, weight, etc.
+- Reduced time for an ONIX2::Reader class to initialise
+
+v0.4.0 (28th October 2008)
+- Major rework: now based on ROXML instead of xml-mapping
+  - Mostly API Compatible
+  - StreamReader and StreamWriter renamed to Reader and Writer
+  - ROXML is based on libxml, so things should be significantly faster
+
+v0.2.7 (Unreleased)
+- Add line breaks after each product
+
+v0.2.5 (Unreleased)
+- Make PublishingStatus a two_digit_node
+
+v0.2.4 (Unreleased)
+- Initialise the media files array of a new product correctly
+
+v0.2.3 (Unreleased)
+- Switch a few more fields over to TwoDigitNodes
+- Make the product availability field accessible from APAProduct
+
+v0.2.2 (Unreleased)
+- Add a new nodetype (DateNode) for YYYYMMDD fields
+
+v0.2.1 (Unreleased)
+- Add a new nodetype (TwoDigitNode) for two digit codes
+
+v0.2.0 (16th July 2008)
+- Add support for reading and storing subject codes (BIC, BISAC, etc)
+
+v0.1.0 (12th June 2008)
+- Initial Release

data/README.markdown

@@ -0,0 +1,69 @@
+## ONIX
+
+[![Build Status](https://travis-ci.org/exAspArk/onix2.svg?branch=master)](https://travis-ci.org/exAspArk/onix2)
+
+The ONIX standard is a somewhat verbose XML format that is rapidly becoming the
+industry standard for electronic data sharing in the book and publishing
+industries.
+
+This library provides a slim layer over the format and simplifies both reading
+and writing ONIX files in your ruby applications.
+
+This replaces the obsolete rbook-onix gem that was spectacular in its crapness.
+Let us never speak of it again.
+
+## Feature Support
+
+This library currently only handles ONIX 2.1 files (all revisions). At some
+point I'll need to work out what to do about supporting ONIX 3.0 files. I
+suspect a separate library will be the simplest solution.
+
+ONIX2::Reader only handles the reference tag versions of ONIX 2.1. Use
+ONIX2::Normaliser to convert any short tag files to reference tags.
+
+ONIX2::Writer only generates reference tag ONIX files.
+
+It baffles me why anyone thought designing two parallel versions of the ONIX
+spec was a good idea. Use reference tags my friends, and let short tags fade
+away into irrelevant obscurity.
+
+## DTD Loading
+
+To correctly handle named entities when reading an ONIX file, this gem attempts
+to load the DTD describing the ONIX format into memory. By default, this means
+each file you read will require several hundred Kb of data to be downloaded
+over the net.
+
+This is obviously not desirable in most cases. To avoid it, you need to add copies
+of the ONIX DTDs into your system XML catalog. On Debian and Ubuntu systems,
+the quickest way to do that is to build and install the package available @
+http://github.com/yob/onix-dtd
+
+## Installation
+
+    gem install onix
+
+## Usage
+
+See files in the examples directory to get started quickly. For further reading
+view the comments to the following classes:
+
+* ONIX2::Reader - For reading ONIX files
+* ONIX2::Writer - For writing ONIX files
+* ONIX2::Normaliser - For normalising ONIX files before reading them. Fixes encoding issues, etc
+* ONIX2::Lists  - For building hashes of code lists from the ONIX spec
+
+## Licensing
+
+This library is distributed under the terms of the MIT License. See the included file for
+more detail.
+
+## Contributing
+
+All suggestions and patches welcome, preferably via a git repository I can pull from.
+To be honest, I'm not really expecting any, this is a niche library.
+
+## Further Reading
+
+- The source: [http://github.com/yob/onix/tree/master](http://github.com/yob/onix/tree/master)
+- The official specs [http://www.editeur.org/8/ONIX/](http://www.editeur.org/8/ONIX/)

data/TODO

@@ -0,0 +1,14 @@
+- finish adding support for all tags in a Product record
+  - contributor still needs some obscure tags added
+- add a new node type for dates that should be in the form YYYYMMDD
+- allow symbols to be used instead of numeric codes
+  - contribution type, id type, etc
+- validations
+  - hard stuff from the spec
+    - 2 digit numbers, 8 digit dates, char limits on text fields
+  - code lists
+    - only values in code lists allowed in relevant fields
+  - regional requirements
+    - titlepage minimum set of tags
+    - APA (if different to titlepage)
+- documentation

data/dtd/2.1r3/iso-amsa.ent

@@ -0,0 +1,173 @@
+
+<!--
+     File isoamsa.ent produced by the XSL script mmldtd.xsl
+     from input data in unicode.xml.
+
+     Please report any errors to 
+     David Carlisle <davidc@nag.co.uk>.
+
+     The numeric character values assigned to each entity
+     (should) match either official Unicode assignments
+     or assignments provisionally allocated by the
+     Unicode Consortium based on the characters in the `STIX'
+     propsal for mathematics. Note that these assignments
+     have not been ratified by the corresponding ISO
+     committee and thus should be considered liable to
+     change.
+
+     Entity names in this file are derived from files carrying the
+     following notice:
+
+     (C) International Organization for Standardization 1991
+     Permission to copy in any form is granted for use with
+     conforming SGML systems and applications as defined in
+     ISO 8879, provided this notice is included in all copies.
+
+-->
+
+<!ENTITY angzarr          "&#x0237C;" ><!--angle with down zig-zag arrow -->
+<!ENTITY cirmid           "&#x02AEF;" ><!--circle, mid below -->
+<!ENTITY cudarrl          "&#x02938;" ><!--left, curved, down arrow -->
+<!ENTITY cudarrr          "&#x02935;" ><!--right, curved, down arrow -->
+<!ENTITY cularr           "&#x021B6;" ><!--/curvearrowleft A: left curved arrow -->
+<!ENTITY cularrp          "&#x0293D;" ><!--curved left arrow with plus -->
+<!ENTITY curarr           "&#x021B7;" ><!--/curvearrowright A: rt curved arrow -->
+<!ENTITY curarrm          "&#x0293C;" ><!--curved right arrow with minus -->
+<!ENTITY dArr             "&#x021D3;" ><!--/Downarrow A: down dbl arrow -->
+<!ENTITY Darr             "&#x021A1;" ><!--down two-headed arrow -->
+<!ENTITY ddarr            "&#x021CA;" ><!--/downdownarrows A: two down arrows -->
+<!ENTITY DDotrahd         "&#x02911;" ><!--right arrow with dotted stem -->
+<!ENTITY dfisht           "&#x0297F;" ><!--down fish tail -->
+<!ENTITY dHar             "&#x02965;" ><!--down harpoon-left, down harpoon-right -->
+<!ENTITY dharl            "&#x021C3;" ><!--/downharpoonleft A: dn harpoon-left -->
+<!ENTITY dharr            "&#x021C2;" ><!--/downharpoonright A: down harpoon-rt -->
+<!ENTITY duarr            "&#x021F5;" ><!--down arrow, up arrow -->
+<!ENTITY duhar            "&#x0296F;" ><!--down harp, up harp -->
+<!ENTITY dzigrarr         "&#x0F5A2;" ><!--right long zig-zag arrow -->
+<!ENTITY erarr            "&#x02971;" ><!--equal, right arrow below -->
+<!ENTITY harr             "&#x02194;" ><!--/leftrightarrow A: l&r arrow -->
+<!ENTITY hArr             "&#x021D4;" ><!--/Leftrightarrow A: l&r dbl arrow -->
+<!ENTITY harrcir          "&#x02948;" ><!--left and right arrow with a circle -->
+<!ENTITY harrw            "&#x021AD;" ><!--/leftrightsquigarrow A: l&r arr-wavy -->
+<!ENTITY hoarr            "&#x021FF;" ><!--horizontal open arrow -->
+<!ENTITY imof             "&#x022B7;" ><!--image of -->
+<!ENTITY lAarr            "&#x021DA;" ><!--/Lleftarrow A: left triple arrow -->
+<!ENTITY Larr             "&#x0219E;" ><!--/twoheadleftarrow A: -->
+<!ENTITY larrbfs          "&#x0291F;" ><!--left arrow-bar, filled square -->
+<!ENTITY larrfs           "&#x0291D;" ><!--left arrow, filled square -->
+<!ENTITY larrhk           "&#x021A9;" ><!--/hookleftarrow A: left arrow-hooked -->
+<!ENTITY larrlp           "&#x021AB;" ><!--/looparrowleft A: left arrow-looped -->
+<!ENTITY larrpl           "&#x02939;" ><!--left arrow, plus -->
+<!ENTITY larrsim          "&#x02973;" ><!--left arrow, similar -->
+<!ENTITY larrtl           "&#x021A2;" ><!--/leftarrowtail A: left arrow-tailed -->
+<!ENTITY latail           "&#x02919;" ><!--left arrow-tail -->
+<!ENTITY lAtail           "&#x0291B;" ><!--left double arrow-tail -->
+<!ENTITY lbarr            "&#x0290C;" ><!--left broken arrow -->
+<!ENTITY lBarr            "&#x0290E;" ><!--left doubly broken arrow -->
+<!ENTITY ldca             "&#x02936;" ><!--left down curved arrow -->
+<!ENTITY ldrdhar          "&#x02967;" ><!--left harpoon-down over right harpoon-down -->
+<!ENTITY ldrushar         "&#x0294B;" ><!--left-down-right-up harpoon -->
+<!ENTITY ldsh             "&#x021B2;" ><!--left down angled arrow -->
+<!ENTITY lfisht           "&#x0297C;" ><!--left fish tail -->
+<!ENTITY lHar             "&#x02962;" ><!--left harpoon-up over left harpoon-down -->
+<!ENTITY lhard            "&#x021BD;" ><!--/leftharpoondown A: l harpoon-down -->
+<!ENTITY lharu            "&#x021BC;" ><!--/leftharpoonup A: left harpoon-up -->
+<!ENTITY lharul           "&#x0296A;" ><!--left harpoon-up over long dash -->
+<!ENTITY llarr            "&#x021C7;" ><!--/leftleftarrows A: two left arrows -->
+<!ENTITY llhard           "&#x0296B;" ><!--left harpoon-down below long dash -->
+<!ENTITY loarr            "&#x021FD;" ><!--left open arrow -->
+<!ENTITY lrarr            "&#x021C6;" ><!--/leftrightarrows A: l arr over r arr -->
+<!ENTITY lrhar            "&#x021CB;" ><!--/leftrightharpoons A: l harp over r -->
+<!ENTITY lrhard           "&#x0296D;" ><!--right harpoon-down below long dash -->
+<!ENTITY lsh              "&#x021B0;" ><!--/Lsh A: -->
+<!ENTITY lurdshar         "&#x0294A;" ><!--left-up-right-down harpoon -->
+<!ENTITY luruhar          "&#x02966;" ><!--left harpoon-up over right harpoon-up -->
+<!ENTITY map              "&#x021A6;" ><!--/mapsto A: -->
+<!ENTITY Map              "&#x02905;" ><!--twoheaded mapsto -->
+<!ENTITY midcir           "&#x02AF0;" ><!--mid, circle below  -->
+<!ENTITY mumap            "&#x022B8;" ><!--/multimap A: -->
+<!ENTITY nearhk           "&#x02924;" ><!--NE arrow-hooked -->
+<!ENTITY nearr            "&#x02197;" ><!--/nearrow A: NE pointing arrow -->
+<!ENTITY neArr            "&#x021D7;" ><!--NE pointing dbl arrow -->
+<!ENTITY nesear           "&#x02928;" ><!--/toea A: NE & SE arrows -->
+<!ENTITY nharr            "&#x021AE;" ><!--/nleftrightarrow A: not l&r arrow -->
+<!ENTITY nhArr            "&#x021CE;" ><!--/nLeftrightarrow A: not l&r dbl arr -->
+<!ENTITY nlarr            "&#x0219A;" ><!--/nleftarrow A: not left arrow -->
+<!ENTITY nlArr            "&#x021CD;" ><!--/nLeftarrow A: not implied by -->
+<!ENTITY nrarr            "&#x0219B;" ><!--/nrightarrow A: not right arrow -->
+<!ENTITY nrArr            "&#x021CF;" ><!--/nRightarrow A: not implies -->
+<!ENTITY nrarrc           "&#x02933;&#x00338;" ><!--not right arrow-curved -->
+<!ENTITY nrarrw           "&#x0219D;&#x00338;" ><!--not right arrow-wavy -->
+<!ENTITY nvHarr           "&#x021CE;" ><!--not, vert, left and right double arrow  -->
+<!ENTITY nvlArr           "&#x021CD;" ><!--not, vert, left double arrow -->
+<!ENTITY nvrArr           "&#x021CF;" ><!--not, vert, right double arrow -->
+<!ENTITY nwarhk           "&#x02923;" ><!--NW arrow-hooked -->
+<!ENTITY nwarr            "&#x02196;" ><!--/nwarrow A: NW pointing arrow -->
+<!ENTITY nwArr            "&#x021D6;" ><!--NW pointing dbl arrow -->
+<!ENTITY nwnear           "&#x02927;" ><!--NW & NE arrows -->
+<!ENTITY olarr            "&#x021BA;" ><!--/circlearrowleft A: l arr in circle -->
+<!ENTITY orarr            "&#x021BB;" ><!--/circlearrowright A: r arr in circle -->
+<!ENTITY origof           "&#x022B6;" ><!--original of -->
+<!ENTITY rAarr            "&#x021DB;" ><!--/Rrightarrow A: right triple arrow -->
+<!ENTITY Rarr             "&#x021A0;" ><!--/twoheadrightarrow A: -->
+<!ENTITY rarrap           "&#x02975;" ><!--approximate, right arrow above -->
+<!ENTITY rarrbfs          "&#x02920;" ><!--right arrow-bar, filled square -->
+<!ENTITY rarrc            "&#x02933;" ><!--right arrow-curved -->
+<!ENTITY rarrfs           "&#x0291E;" ><!--right arrow, filled square -->
+<!ENTITY rarrhk           "&#x021AA;" ><!--/hookrightarrow A: rt arrow-hooked -->
+<!ENTITY rarrlp           "&#x021AC;" ><!--/looparrowright A: rt arrow-looped -->
+<!ENTITY rarrpl           "&#x02945;" ><!--right arrow, plus -->
+<!ENTITY rarrsim          "&#x02974;" ><!--right arrow, similar -->
+<!ENTITY rarrtl           "&#x021A3;" ><!--/rightarrowtail A: rt arrow-tailed -->
+<!ENTITY Rarrtl           "&#x02916;" ><!--right two-headed arrow with tail -->
+<!ENTITY rarrw            "&#x0219D;" ><!--/rightsquigarrow A: rt arrow-wavy -->
+<!ENTITY ratail           "&#x021A3;" ><!--right arrow-tail -->
+<!ENTITY rAtail           "&#x0291C;" ><!--right double arrow-tail -->
+<!ENTITY rbarr            "&#x0290D;" ><!--/bkarow A: right broken arrow -->
+<!ENTITY rBarr            "&#x0290F;" ><!--/dbkarow A: right doubly broken arrow -->
+<!ENTITY RBarr            "&#x02910;" ><!--/drbkarow A: twoheaded right broken arrow -->
+<!ENTITY rdca             "&#x02937;" ><!--right down curved arrow -->
+<!ENTITY rdldhar          "&#x02969;" ><!--right harpoon-down over left harpoon-down -->
+<!ENTITY rdsh             "&#x021B3;" ><!--right down angled arrow -->
+<!ENTITY rfisht           "&#x0297D;" ><!--right fish tail -->
+<!ENTITY rHar             "&#x02964;" ><!--right harpoon-up over right harpoon-down -->
+<!ENTITY rhard            "&#x021C1;" ><!--/rightharpoondown A: rt harpoon-down -->
+<!ENTITY rharu            "&#x021C0;" ><!--/rightharpoonup A: rt harpoon-up -->
+<!ENTITY rharul           "&#x0296C;" ><!--right harpoon-up over long dash -->
+<!ENTITY rlarr            "&#x021C4;" ><!--/rightleftarrows A: r arr over l arr -->
+<!ENTITY rlhar            "&#x021CC;" ><!--/rightleftharpoons A: r harp over l -->
+<!ENTITY roarr            "&#x021FE;" ><!--right open arrow -->
+<!ENTITY rrarr            "&#x021C9;" ><!--/rightrightarrows A: two rt arrows -->
+<!ENTITY rsh              "&#x021B1;" ><!--/Rsh A: -->
+<!ENTITY ruluhar          "&#x02968;" ><!--right harpoon-up over left harpoon-up -->
+<!ENTITY searhk           "&#x02925;" ><!--/hksearow A: SE arrow-hooken -->
+<!ENTITY searr            "&#x02198;" ><!--/searrow A: SE pointing arrow -->
+<!ENTITY seArr            "&#x021D8;" ><!--SE pointing dbl arrow -->
+<!ENTITY seswar           "&#x02929;" ><!--/tosa A: SE & SW arrows -->
+<!ENTITY simrarr          "&#x02972;" ><!--similar, right arrow below -->
+<!ENTITY slarr            "&#x02190;&#x0FE00;" ><!--short left arrow -->
+<!ENTITY srarr            "&#x02192;&#x0FE00;" ><!--short right arrow -->
+<!ENTITY swarhk           "&#x02926;" ><!--/hkswarow A: SW arrow-hooked -->
+<!ENTITY swarr            "&#x02199;" ><!--/swarrow A: SW pointing arrow -->
+<!ENTITY swArr            "&#x021D9;" ><!--SW pointing dbl arrow -->
+<!ENTITY swnwar           "&#x0292A;" ><!--SW & NW arrows -->
+<!ENTITY uArr             "&#x021D1;" ><!--/Uparrow A: up dbl arrow -->
+<!ENTITY Uarr             "&#x0219F;" ><!--up two-headed arrow -->
+<!ENTITY Uarrocir         "&#x02949;" ><!--up two-headed arrow above circle -->
+<!ENTITY udarr            "&#x021C5;" ><!--up arrow, down arrow -->
+<!ENTITY udhar            "&#x0296E;" ><!--up harp, down harp -->
+<!ENTITY ufisht           "&#x0297E;" ><!--up fish tail -->
+<!ENTITY uHar             "&#x02963;" ><!--up harpoon-left, up harpoon-right -->
+<!ENTITY uharl            "&#x021BF;" ><!--/upharpoonleft A: up harpoon-left -->
+<!ENTITY uharr            "&#x021BE;" ><!--/upharpoonright /restriction A: up harp-r -->
+<!ENTITY uuarr            "&#x021C8;" ><!--/upuparrows A: two up arrows -->
+<!ENTITY varr             "&#x02195;" ><!--/updownarrow A: up&down arrow -->
+<!ENTITY vArr             "&#x021D5;" ><!--/Updownarrow A: up&down dbl arrow -->
+<!ENTITY xharr            "&#x0F578;" ><!--/longleftrightarrow A: long l&r arr -->
+<!ENTITY xhArr            "&#x0F57B;" ><!--/Longleftrightarrow A: long l&r dbl arr -->
+<!ENTITY xlarr            "&#x0F576;" ><!--/longleftarrow A: long left arrow -->
+<!ENTITY xlArr            "&#x0F579;" ><!--/Longleftarrow A: long l dbl arrow -->
+<!ENTITY xmap             "&#x0F57D;" ><!--/longmapsto A: -->
+<!ENTITY xrarr            "&#x0F577;" ><!--/longrightarrow A: long right arrow -->
+<!ENTITY xrArr            "&#x0F57A;" ><!--/Longrightarrow A: long rt dbl arr -->
+<!ENTITY zigrarr          "&#x021DD;" ><!--right zig-zag arrow -->