Doc

doc/USAGE.md

@@ -666,7 +666,32 @@ Playlist title formatting (how tags are shown) should follow player's config, as
 vgmstream simply passes tags to the player. It's better to name the file lowercase
 `!tags.m3u` rather than `!Tags.m3u` (Windows accepts both but Linux is case sensitive).
 
-Note that with global tags you don't need to put all files inside. This would be
+Example:
+```
+# @ALBUM    God Hand
+# @ARTIST   Masafumi Takada, Jun Fukuda
+# * Global tags apply to all songs, unless overwritten
+#   Better use ARTIST instead of ALBUMARTIST (more compatible)
+#   Tags usually go in CAPS for readability but no differences
+
+# $AUTOTRACK
+# * This adds TRACK tags automatically from 1 to N
+
+# %ARTIST   Masafumi Takada
+# %TITLE    Be ready for it
+godhand_ver1.adx
+
+#... (more songs)
+
+# %ARTIST   Jun Fukuda
+# %TITLE    Duel Storm
+Boss8_DevilHandHONKI_Ver9.adx
+
+#... (more songs)
+
+```
+
+Note that with global tags you don't need to put all files or info inside. This would be
 a perfectly valid *!tags.m3u*:
 ```
 # @ALBUM    Game
@@ -706,7 +731,8 @@ filename1
 ```
 As a side effect if text has @/% inside you also need them: `# @ALBUMARTIST@ Tom-H@ck`
 
-For interoperability with other plugins, consider using only common tags without spaces.
+For interoperability with other plugins, consider using only common tags without spaces,
+and tags that are commonly accepted in all players like ARTIST instead of ALBUMARTIST.
 
 ### ReplayGain
 foobar2000/Winamp can apply the following replaygain tags (if ReplayGain is

version.h

@@ -11,6 +11,27 @@
  * Version is autogenerated from Git (passed via compiler args, or updated with scripts), but this file is
  * for Git-less builds (not installed or downloaded master). Builds that don't do the above should still work
  * (compiling a well-behaved src shouldn't depend on calling arbitrary scripts). */
+
+/* Generating new releases:
+ * - calculate new version
+ *   - check last release's latest PR
+ *   - count number or PRs (more or less) since then
+ *   - add that count to current version (commit count not used since there are a lot and some are useless)
+ * - update VGMSTREAM_VERSION "rNNNN" and commit
+ *   - may be done directly without PR
+ * - create a new release/tag (same name as version, rNNNN), with that commit as a base
+ *   - use latest if version change commit was without PR
+ * - compile and upload
+ *   - on github, after changing version:
+ *     - releases > "draft new release" button
+ *     - write text and select commit + tag
+ *     - publish (even with no binaries) 
+ *     - in "actions" tab, workflow should have added a new "rXXXX" compilation
+ *     - once done download all binaries there, edit release, upload, save
+ * - if version commit was used correctly as release base, "git describe" and plugin
+ *   versions should return "rNNNN" without extra text commit number text
+ */
+
 #define VGMSTREAM_VERSION "r1776"
 #endif
 #endif