### Author:  [@Florian](https://community.mp3tag.de/u/Florian)
#### Post date: [March 7, 2022, 4:04pm UTC](https://community.mp3tag.de/t/updated-documentation-work-in-progress/56547/43 "2022-03-07T16:04:59Z")
Yes, but it's a little more tricky with the filter. What would be a text constant without spaces in a generating format string is a field reference in the Filter.
`artist HAS test` matches if any of the values in field `ARTIST` contains `test`, so it's not really treated as a text constant as in the context of format strings.
You can see the filter working with field names (not enclosed in %), which then uses value-lookup for the referenced field and uses the resulting string for matching. The extended functionality of the filter is allowing format strings instead of field names (anything with % or $ and enclosed in ") where the string is matched against the evaluated format string.
---
### Author:  [@ohrenkino](https://community.mp3tag.de/u/ohrenkino)
#### Post date: [March 7, 2022, 4:23pm UTC](https://community.mp3tag.de/t/updated-documentation-work-in-progress/56547/44 "2022-03-07T16:23:15Z")
Admittedly, I did not consider this special function of the filter.
Yet, I think that the overlap between "generating format string" and the functions of the filter is larger than that of a field - as "field" is also used for the mappings and other references to fields and fields contents.
I agree that this behaviour has to be described but I disagree to call it a ``.
I would not introduce a new meaning for "field" but use the note instead to decribe that additionally to the otherwise used reference to fields here, in this case, the % may be omitted (but even this is not mandatory).
---
### Author:  [@MotleyG](https://community.mp3tag.de/u/MotleyG)
#### Post date: [March 7, 2022, 5:16pm UTC](https://community.mp3tag.de/t/updated-documentation-work-in-progress/56547/45 "2022-03-07T17:16:26Z")
> [@Florian](#):
>
> You can see the filter working with field names (not enclosed in %), which then uses value-lookup for the referenced field and uses the resulting string for matching
I didn't realize this was possible even after all these years. My "learned something new" for today! 👍
---
### Author:  [@ohrenkino](https://community.mp3tag.de/u/ohrenkino)
#### Post date: [March 10, 2022, 4:41pm UTC](https://community.mp3tag.de/t/updated-documentation-work-in-progress/56547/46 "2022-03-10T16:41:05Z")
Problems occur right now if older threads link to the old German help pages, like e.g. (my) post:
> [@Titel tags bearbeiten](https://community.mp3tag.de/t/titel-tags-bearbeiten/44824/21):
>
> Vielleicht verstehe ich auch nicht Nein. Dies heißt "Nimm soviele beliebige Zeichen wie möglich und merk sie dir". Nein. Das heißt: "Finde ein Muster, das mit einer öffnenden Klammer beginnt, dann beliebige Zeichen enthält und mit einer schließenden Klammer endet" Wenn du (.\*) \(.\*\)zusammen nimmst, wird daraus: "Merk dir so viele Zeichen wie möglich bis du ein Muster findest, das mit einer öffnenden Klammer beginnt, dann beliebige Zeichen enthält und mit einer schließenden Klammer endet". …
The original link intended to open the syntax reference for regular expressions which was formerly situated in the description of the action "Replace with regular expression".
`https://docs.mp3tag.de/actions/replace-regexp/?de`
This is now mapped to
`https://docs.mp3tag.de/actions/#regexp`
but it does not jump to the bookmark on that page and also, it does not show the regular expression which is now in a separate chapter:
`https://docs.mp3tag.de/regex/`
(which I think is better to have the regular expression syntax in 1 place as it can be used in the context of actions, scripting and filtering)
Yet, the old link is not correct any more.
---
### Author:  [@Florian](https://community.mp3tag.de/u/Florian)
#### Post date: [March 10, 2022, 6:50pm UTC](https://community.mp3tag.de/t/updated-documentation-work-in-progress/56547/47 "2022-03-10T18:50:42Z")
Thanks, I'm aware of the issue. I've remapped all the [help.mp3tag.de](http://help.mp3tag.de) links in the forum to the new URLs, but had enough after one day of replacing strings directly in the database.
It's impossible to distinguish your special case, though. However, even if linked to [Replace with Regular Expression – Mp3tag Documentation](https://docs.mp3tag.de/actions/replace-regexp/), it's only one step away from the syntax reference. The same applies to options\_export.html, which was often used as reference for [Format Strings and Placeholders – Mp3tag Documentation](https://docs.mp3tag.de/format/) — but is now [Exporting Tag and File Information – Mp3tag Documentation](https://docs.mp3tag.de/export/)
---
### Author:  [@ohrenkino](https://community.mp3tag.de/u/ohrenkino)
#### Post date: [March 10, 2022, 7:03pm UTC](https://community.mp3tag.de/t/updated-documentation-work-in-progress/56547/48 "2022-03-10T19:03:08Z")
I have to admit that I don't know how to untangle this Gordian knot.
Perhaps it is an idea to replace the links on a case by case basis.
---
### Author:  [@ohrenkino](https://community.mp3tag.de/u/ohrenkino)
#### Post date: [March 10, 2022, 7:04pm UTC](https://community.mp3tag.de/t/updated-documentation-work-in-progress/56547/49 "2022-03-10T19:04:24Z")
Something different:
The Mac section has a dedicated "Documentation" category.
Will there be a "Documentation" category for MP3tag for Windows?
---
### Author:  [@Florian](https://community.mp3tag.de/u/Florian)
#### Post date: [March 10, 2022, 7:25pm UTC](https://community.mp3tag.de/t/updated-documentation-work-in-progress/56547/50 "2022-03-10T19:25:10Z")
> [@ohrenkino](#):
>
> Will there be a "Documentation" category for MP3tag for Windows?
It's not planned at the moment, why are you asking?
---
### Author:  [@ohrenkino](https://community.mp3tag.de/u/ohrenkino)
#### Post date: [March 10, 2022, 7:29pm UTC](https://community.mp3tag.de/t/updated-documentation-work-in-progress/56547/51 "2022-03-10T19:29:57Z")
I found the category quite appealing in the Mac section.
It shows openly the functions and features - and you don't have to "know" the address, it is publicly visible as part of the huge knowledge that has so far been accumulated around MP3tag.
You can see more details without the need to install MP3tag (to press F1 or call the help) if you can access the link to the documenation via the forum navigation.
---
### Author:  [@Florian](https://community.mp3tag.de/u/Florian)
#### Post date: [March 14, 2022, 7:19pm UTC](https://community.mp3tag.de/t/updated-documentation-work-in-progress/56547/52 "2022-03-14T19:19:17Z")
> [@LyricsLover](#):
>
> I suggest to release an additional overview in table format for the [tag mapping](https://docs.mp3tag.de/mapping/)
I've added a table linked from the mapping section.
> [@ohrenkino](#):
>
> Perhaps it is an idea to replace the links on a case by case basis.
I went through it case by case 🤪
---
### Author:  [@Florian](https://community.mp3tag.de/u/Florian)
#### Post date: [March 24, 2022, 11:16am UTC](https://community.mp3tag.de/t/updated-documentation-work-in-progress/56547/53 "2022-03-24T11:16:52Z")
I've now officially released the new documentation with Mp3tag v3.13. Thank you all, especially @ohrenkino, for your helpful and valuable feedback during the whole process of re-writing and re-structuring.
I think it's in very good shape now and much easier for me to keep updated. I've already noticed that it got easier to link to the documentation, because I know that it's not outdated or incomplete.
Here you go:
> **[Mp3tag Documentation](https://docs.mp3tag.de)**
>
> Mp3tag is the universal Tag Editor. It supports editing of metadata and cover art for many different audio and video formats (MP3, MP4, FLAC, WAV, ...), file renaming, metadata import and repeatable actions.
---
### Author:  [@Zerow](https://community.mp3tag.de/u/Zerow)
#### Post date: [March 24, 2022, 6:13pm UTC](https://community.mp3tag.de/t/updated-documentation-work-in-progress/56547/54 "2022-03-24T18:13:39Z")
> [@Mp3tag v3.13 and v3.14 released](https://community.mp3tag.de/t/mp3tag-v3-13-and-v3-14-released/56785/1):
>
> [...]
>
> ### Revised Documentation
>
> I’ve rewritten and updated most of the existing help files and published them at [https://docs.mp3tag.de](https://docs.mp3tag.de)
> [...]
>
> - added support for using online documentation as internal help.
> [...]
1] Why send the user to the website? What happens if the user's Internet connection is down?
2] Why remain old help files at `C:\Program Files (x86)\Mp3tag\help\` when the first three entries in the `Help` tab send the user to the never version posted on-line?
3] How to access those locally stored help files from within Mp3tag? Which button or menu entry takes to that content?
---
### Author:  [@ohrenkino](https://community.mp3tag.de/u/ohrenkino)
#### Post date: [March 24, 2022, 6:29pm UTC](https://community.mp3tag.de/t/updated-documentation-work-in-progress/56547/55 "2022-03-24T18:29:06Z")
> [@Zerow](#):
>
> 1] Why send the user to the website? What happens if the user's Internet connection is down?
A fair number of functions rely on the internet access - so now this also applies to the help. This is a change in function that the developer is entitled to do.
> [@Zerow](#):
>
> Why remain old help files at `C:\Program Files (x86)\Mp3tag\help\` when the first three entries in the `Help` tab send the user to the never version posted on-line?
You may delete the help if you don't want it or you may keep it. The up-to-date and valid help is now online.
> [@Zerow](#):
>
> 3] How to access those locally stored help files from within Mp3tag? Which button or menu entry takes to that content?
This function has been replaced with the access to the online help.
If you want to call the old help from within MP3tag, create yourself a tool for the html start page of the old, now outdated help.
---
### Author:  [@Zerow](https://community.mp3tag.de/u/Zerow)
#### Post date: [March 24, 2022, 6:56pm UTC](https://community.mp3tag.de/t/updated-documentation-work-in-progress/56547/56 "2022-03-24T18:56:31Z")
> [@ohrenkino](#):
>
> [...]
> If you want to call the old help from within MP3tag, create yourself a tool for the html start page of the old, now outdated help.
Eee... my overall intention was to be able to use a dark themed version of the help files [[Dark Theme missed elements - #7 by Zerow](https://community.mp3tag.de/t/dark-theme-missed-elements/54891/7)]. The only thing missing now is the offline [still dark] version of them. [And no: saving the HTML files and opening them from drive in the same web browser will not do the trick]
---
### Author:  [@ohrenkino](https://community.mp3tag.de/u/ohrenkino)
#### Post date: [March 30, 2022, 9:00am UTC](https://community.mp3tag.de/t/updated-documentation-work-in-progress/56547/57 "2022-03-30T09:00:49Z")
> **[Tag Field Mappings Table – Mp3tag Documentation](https://docs.mp3tag.de/mapping-table/)**
>
> Overview of all available tag fields, their names in Mp3tag, and how they are mapped to the internal structures of the different tag formats. Mp3tag is the universal Tag Editor.
and
> **[Tag Field Mappings – Mp3tag Documentation](https://docs.mp3tag.de/mapping/)**
>
> Overview of all available tag fields, their names in Mp3tag, and how they are mapped to the internal structures of the different tag formats. Mp3tag is the universal Tag Editor.
It would be great if the variables had their own labels as hyperlink target so that a link to the description of the variable would jump not only to the main page but directly to the section on the page where the description of a particular variable can be found.
---
### Author:  [@Florian](https://community.mp3tag.de/u/Florian)
#### Post date: [March 30, 2022, 1:02pm UTC](https://community.mp3tag.de/t/updated-documentation-work-in-progress/56547/58 "2022-03-30T13:02:26Z")
All of those now have anchor IDs, e.g., [https://docs.mp3tag.de/mapping/#popularimeter](https://docs.mp3tag.de/mapping/#popularimeter) and I've now also added small link icons that appear when you hover over the heading.
I've also added links to all other headings, e.g., [https://docs.mp3tag.de/format/#technical-information](https://docs.mp3tag.de/format/#technical-information) with the small link icon.
---
### Author:  [@esumsea](https://community.mp3tag.de/u/esumsea)
#### Post date: [April 9, 2022, 2:55pm UTC](https://community.mp3tag.de/t/updated-documentation-work-in-progress/56547/59 "2022-04-09T14:55:04Z")
For the Tag field Mappings found here [Tag Field Mappings – Mp3tag Documentation](https://docs.mp3tag.de/mapping/)
can you include the old table at the end. I found it useful, and sometimes gave better clarity visually. If not, can you post a link to a file I can download and keep. Thanks for all your work on this!
---
### Author:  [@ohrenkino](https://community.mp3tag.de/u/ohrenkino)
#### Post date: [April 9, 2022, 2:57pm UTC](https://community.mp3tag.de/t/updated-documentation-work-in-progress/56547/60 "2022-04-09T14:57:37Z")
On that page there is a link
- Tag Field Mappings overview as a [table](https://docs.mp3tag.de/mapping-table)
[Previous page](https://community.mp3tag.de/t/updated-documentation-work-in-progress/56547.md?page=2)
[Next page](https://community.mp3tag.de/t/updated-documentation-work-in-progress/56547.md?page=4)