BUG: Manual seems to be wrong about tags in Library screen and tags in Pdf reader screen being different

[raindropsfromsky]

The Qiqqa manual (p.12) states that-

Note that tags you associate with PDFs are different to tags you associate with Annotations (see Section 7). The former are used to filter PDFs in the Library screen. The latter are used to build tag-specific Annotation Reports.

However, if I open any file in the pdf reader screen, and apply new tags to it using the Annotation >Tags section,

...they appear in the Tags list on the Library screen. This is confirmed further, as new tags get added only after I refresh the list.

[GerHobbelt]

The tags in the latter left panel purpose is filtering the library document set by tag. These tags are the greatest common superset of all tags assigned to all documents in the library. I must admit I've never produced Annotation Reports, so I don't know about those, but they surely will use the tags defined for the documents. Heck, I never used the manual to guide me in using Qiqqa so I never checked it for odd wordings and/or errors yet.

Anyway, in a sense, they may seem "the same tags", but these are the tags obtained from the tags the user has set up in the Annotations for the documents. Depending on your POV, I guess these two sets can also be called "different" as the one is bound to a document and the other to a library (though constructed as a superset of the documents' tags). Ahhh... headache. The text in the manual gives me some cognitive dissonance and now I'm wondering what was actually meant there. Anyway, don't know how to describe it better right now than using the mathematical term "superset".

(If you start using them, of course both sets are the same, as there's only one document with tags yet then.)

[raindropsfromsky]

Well, we can simply describe tags as follows:

Tags are typically used to describe the attributes of a file. It may be-

• The main topics covered in the file
• Your intent about the file (e.g. "Important!", "To be translated", etc)
• Some other information about the file (e.g. "Copyrighted!")

As you apply a new tag to any file, Qiqqa adds it to a set of tags for the library. (It maintains a separate set of tags for each library.)

Thus, when you switch to a file view, you see all the tags assigned to it. When you switch to a library view, you see the superset of all tags assigned to its files. (Even if a tag is applied to multiple files, it is listed only once in the library view.)

Although the tags are defined at file level, they are actually used in the Library view: You can filter the list of files based on any logical combination of tags.