Object equality: doctest-able examples covering special cases

There is a lack of concrete examples in the API reference across the equals methods available on the various construct and data objects (see e.g. the end of the references here and here) so during #254 we agreed it would be good to add in a good range of examples, ideally eventually doctest-able (i.e. inclusive of set-up of the objects referred to), which in the process of verifying and documenting should enable us to ensure behaviour is known and consistent in relation to such aspects as:

• management of self-equality (a.equals(a)) and whether to short-circuit on copies (a.equals(a.copy()));
• handling of subtleties of data (including relevant keywords to toggle these), e.g: how to deal with masked arrays, NaN values, different data types with equivalent data, compression etc.;
• handling of potential subtleties of metadata (not explored so much as with the above in #254, but I don't doubt there are some).

Esamina prima i riferimenti all’API equals collegati nell’issue e le decisioni di #254. Fai un inventario dei metodi equals dei costrutti e degli oggetti dati, quindi definisci esempi doctest-able che coprano l’uguaglianza con sé stessi, le copie, gli array mascherati, i valori NaN, i tipi di dati, la compressione e i metadati. Il lavoro è completato quando gli esempi documentati possono essere eseguiti come doctests e i comportamenti rilevanti sono espliciti e coerenti.