finalize 1.2.0

CHANGELOG.md

@@ -1,8 +1,8 @@
 opustags changelog
 ==================
 
-1.2.0 - TBA
------------
+1.2.0 - 2018-11-25
+------------------
 
 - Preserve extra data in OpusTags past the comments.
 - Improve error reporting.
@@ -10,7 +10,7 @@ opustags changelog
 
 This is the biggest release for opustags. The whole code base was reviewed for robustness and
 clarity. The program is now built as C++14, and the code refactored without sacrificing the
-original simplicity. It is shipped with a new test suite for preventing regressions.
+original simplicity. It is shipped with a new test suite.
 
 1.1.1 - 2018-10-24
 ------------------

README.md

@@ -34,7 +34,7 @@ Installing
 
 opustags is a commonplace CMake project.
 
-Here's how to install it in your .local, under your home:
+Here's how to install it in your `.local`, under your home:
 
     mkdir build
     cd build
@@ -53,12 +53,13 @@ Documentation
 
     Options:
       -h, --help              print this help
-      -o, --output            write the modified tags to a file
+      -o, --output FILE       set the output file
+      -i, --in-place          overwrite the input file instead of writing a different output file
       -y, --overwrite         overwrite the output file if it already exists
-      -d, --delete FIELD      delete all the fields of a specified type
-      -a, --add FIELD=VALUE   add a field
-      -s, --set FIELD=VALUE   delete then add a field
-      -D, --delete-all        delete all the fields!
-      -S, --set-all           read the fields from stdin
+      -a, --add FIELD=VALUE   add a comment
+      -d, --delete FIELD      delete all previously existing comments of a specific type
+      -D, --delete-all        delete all the previously existing comments
+      -s, --set FIELD=VALUE   replace a comment (shorthand for --delete FIELD --add FIELD=VALUE)
+      -S, --set-all           replace all the comments with the ones read from standard input
 
 See the man page, `opustags.1`, for extensive documentation.

opustags.1

@@ -112,3 +112,5 @@ tags without writing them to the Opus file:
 .BR sed (1)
 .SH AUTHOR
 Frédéric Mangano-Tarumi <fmang@mg0.fr>
+.PP
+Report bugs at <https://github.com/fmang/opustags/issues>

src/cli.cc

@@ -286,7 +286,7 @@ ot::status ot::run(ot::options& opt)
 		input = fopen(opt.path_in.c_str(), "r");
 		if (input == nullptr)
 			return {ot::st::standard_error,
-			        "could not open '" + opt.path_in + "' for reading: " + strerror(errno)};
+			        "Could not open '" + opt.path_in + "' for reading: " + strerror(errno)};
 	}
 
 	ot::file output;
@@ -299,7 +299,7 @@ ot::status ot::run(ot::options& opt)
 		output = fopen(opt.path_out.c_str(), "w");
 		if (output == nullptr)
 			return {ot::st::standard_error,
-				"could not open '" + opt.path_out + "' for writing: " + strerror(errno)};
+				"Could not open '" + opt.path_out + "' for writing: " + strerror(errno)};
 	}
 
 	ot::status rc;
@@ -324,7 +324,7 @@ ot::status ot::run(ot::options& opt)
 	if (opt.inplace) {
 		if (rename(opt.path_out.c_str(), opt.path_in.c_str()) == -1)
 			return {ot::st::fatal_error,
-			        "could not move the result to '" + opt.path_in + "': " + strerror(errno)};
+			        "Could not move the result to '" + opt.path_in + "': " + strerror(errno)};
 	}
 
 	return ot::st::ok;