Organize usage output the same way as in the README

CHANGELOG.md

@@ -1,3 +1,7 @@
+## 1.17.2
+
+* Organize usage output the same way as in the README
+
 ## 1.17.1
 
 * Add -T option to coerce the types of feature attributes

README.md

@@ -209,6 +209,7 @@ resolution is obtained than by using a smaller _maxzoom_ or _detail_.
 ### Progress indicator
 
  * `-q` or `--quiet`: Work quietly instead of reporting progress
+ * `-v` or `--version`: Report Tippecanoe's version number
 
 Environment
 -----------

main.cpp

@@ -1996,73 +1996,120 @@ int main(int argc, char **argv) {
 		additional[i] = 0;
 	}
 
-	static struct option long_options[] = {
+	static struct option long_options_orig[] = {
+		{"Output tileset", 0, 0, 0},
 		{"output", required_argument, 0, 'o'},
 		{"output-to-directory", required_argument, 0, 'e'},
+		{"force", no_argument, 0, 'f'},
+		{"allow-existing", no_argument, 0, 'F'},
 
+		{"Tileset description and attribution", 0, 0, 0},
 		{"name", required_argument, 0, 'n'},
-		{"description", required_argument, 0, 'N'},
-		{"layer", required_argument, 0, 'l'},
 		{"attribution", required_argument, 0, 'A'},
+		{"description", required_argument, 0, 'N'},
+
+		{"Input files and layer names", 0, 0, 0},
+		{"layer", required_argument, 0, 'l'},
 		{"named-layer", required_argument, 0, 'L'},
+
+		{"Parallel processing of input", 0, 0, 0},
+		{"read-parallel", no_argument, 0, 'P'},
+
+		{"Projection of input", 0, 0, 0},
+		{"projection", required_argument, 0, 's'},
+
+		{"Zoom levels", 0, 0, 0},
 		{"maximum-zoom", required_argument, 0, 'z'},
 		{"minimum-zoom", required_argument, 0, 'Z'},
-		{"base-zoom", required_argument, 0, 'B'},
+
+		{"Tile resolution", 0, 0, 0},
 		{"full-detail", required_argument, 0, 'd'},
 		{"low-detail", required_argument, 0, 'D'},
 		{"minimum-detail", required_argument, 0, 'm'},
+
+		{"Filtering feature attributes", 0, 0, 0},
 		{"exclude", required_argument, 0, 'x'},
 		{"include", required_argument, 0, 'y'},
-		{"drop-rate", required_argument, 0, 'r'},
+		{"exclude-all", no_argument, 0, 'X'},
-		{"buffer", required_argument, 0, 'b'},
-		{"temporary-directory", required_argument, 0, 't'},
-		{"gamma", required_argument, 0, 'g'},
-		{"prevent", required_argument, 0, 'p'},
-		{"additional", required_argument, 0, 'a'},
-		{"projection", required_argument, 0, 's'},
-		{"simplification", required_argument, 0, 'S'},
-		{"maximum-tile-bytes", required_argument, 0, 'M'},
 		{"attribute-type", required_argument, 0, 'T'},
 
-		{"exclude-all", no_argument, 0, 'X'},
+		{"Dropping a fixed fraction of features by zoom level", 0, 0, 0},
-		{"force", no_argument, 0, 'f'},
+		{"drop-rate", required_argument, 0, 'r'},
-		{"allow-existing", no_argument, 0, 'F'},
+		{"base-zoom", required_argument, 0, 'B'},
-		{"quiet", no_argument, 0, 'q'},
-		{"version", no_argument, 0, 'v'},
-		{"read-parallel", no_argument, 0, 'P'},
-
-		{"coalesce", no_argument, &additional[A_COALESCE], 1},
-		{"reverse", no_argument, &additional[A_REVERSE], 1},
-		{"reorder", no_argument, &additional[A_REORDER], 1},
 		{"drop-lines", no_argument, &additional[A_LINE_DROP], 1},
-		{"check-polygons", no_argument, &additional[A_DEBUG_POLYGON], 1},
 		{"drop-polygons", no_argument, &additional[A_POLYGON_DROP], 1},
-		{"prefer-radix-sort", no_argument, &additional[A_PREFER_RADIX_SORT], 1},
+
-		{"calculate-feature-density", no_argument, &additional[A_CALCULATE_FEATURE_DENSITY], 1},
+		{"Dropping a fraction of features to keep under tile size limits", 0, 0, 0},
-		{"detect-shared-borders", no_argument, &additional[A_DETECT_SHARED_BORDERS], 1},
-		{"increase-gamma-as-needed", no_argument, &additional[A_INCREASE_GAMMA_AS_NEEDED], 1},
 		{"drop-densest-as-needed", no_argument, &additional[A_DROP_DENSEST_AS_NEEDED], 1},
 		{"drop-fraction-as-needed", no_argument, &additional[A_DROP_FRACTION_AS_NEEDED], 1},
 		{"drop-smallest-as-needed", no_argument, &additional[A_DROP_SMALLEST_AS_NEEDED], 1},
-		{"grid-low-zooms", no_argument, &additional[A_GRID_LOW_ZOOMS], 1},
+		{"force-feature-limit", no_argument, &prevent[P_DYNAMIC_DROP], 1},
-		{"detect-longitude-wraparound", no_argument, &additional[A_DETECT_WRAPAROUND], 1},
 
+		{"Dropping tightly overlapping features", 0, 0, 0},
+		{"gamma", required_argument, 0, 'g'},
+		{"increase-gamma-as-needed", no_argument, &additional[A_INCREASE_GAMMA_AS_NEEDED], 1},
+
+		{"Line and polygon simplification", 0, 0, 0},
+		{"simplification", required_argument, 0, 'S'},
 		{"no-line-simplification", no_argument, &prevent[P_SIMPLIFY], 1},
 		{"simplify-only-low-zooms", no_argument, &prevent[P_SIMPLIFY_LOW], 1},
-		{"no-feature-limit", no_argument, &prevent[P_FEATURE_LIMIT], 1},
+		{"no-tiny-polygon-reduction", no_argument, &prevent[P_TINY_POLYGON_REDUCTION], 1},
-		{"no-tile-size-limit", no_argument, &prevent[P_KILOBYTE_LIMIT], 1},
+
-		{"force-feature-limit", no_argument, &prevent[P_DYNAMIC_DROP], 1},
+		{"Attempts to improve shared polygon boundaries", 0, 0, 0},
-		{"preserve-input-order", no_argument, &prevent[P_INPUT_ORDER], 1},
+		{"detect-shared-borders", no_argument, &additional[A_DETECT_SHARED_BORDERS], 1},
-		{"no-polygon-splitting", no_argument, &prevent[P_POLYGON_SPLIT], 1},
+		{"grid-low-zooms", no_argument, &additional[A_GRID_LOW_ZOOMS], 1},
+
+		{"Controlling clipping to tile boundaries", 0, 0, 0},
+		{"buffer", required_argument, 0, 'b'},
 		{"no-clipping", no_argument, &prevent[P_CLIPPING], 1},
 		{"no-duplication", no_argument, &prevent[P_DUPLICATION], 1},
-		{"no-tiny-polygon-reduction", no_argument, &prevent[P_TINY_POLYGON_REDUCTION], 1},
+
+		{"Reordering features within each tile", 0, 0, 0},
+		{"preserve-input-order", no_argument, &prevent[P_INPUT_ORDER], 1},
+		{"reorder", no_argument, &additional[A_REORDER], 1},
+		{"coalesce", no_argument, &additional[A_COALESCE], 1},
+		{"reverse", no_argument, &additional[A_REVERSE], 1},
+
+		{"Adding calculated attributes", 0, 0, 0},
+		{"calculate-feature-density", no_argument, &additional[A_CALCULATE_FEATURE_DENSITY], 1},
+
+		{"Trying to correct bad source geometry", 0, 0, 0},
+		{"detect-longitude-wraparound", no_argument, &additional[A_DETECT_WRAPAROUND], 1},
+
+		{"Setting or disabling tile size limits", 0, 0, 0},
+		{"maximum-tile-bytes", required_argument, 0, 'M'},
+		{"no-feature-limit", no_argument, &prevent[P_FEATURE_LIMIT], 1},
+		{"no-tile-size-limit", no_argument, &prevent[P_KILOBYTE_LIMIT], 1},
 		{"no-tile-compression", no_argument, &prevent[P_TILE_COMPRESSION], 1},
 
+		{"Temporary storage", 0, 0, 0},
+		{"temporary-directory", required_argument, 0, 't'},
+
+		{"Progress indicator", 0, 0, 0},
+		{"quiet", no_argument, 0, 'q'},
+		{"version", no_argument, 0, 'v'},
+
+		{"", 0, 0, 0},
+		{"prevent", required_argument, 0, 'p'},
+		{"additional", required_argument, 0, 'a'},
+		{"check-polygons", no_argument, &additional[A_DEBUG_POLYGON], 1},
+		{"no-polygon-splitting", no_argument, &prevent[P_POLYGON_SPLIT], 1},
+		{"prefer-radix-sort", no_argument, &additional[A_PREFER_RADIX_SORT], 1},
+
 		{0, 0, 0, 0},
 	};
 
+	static struct option long_options[sizeof(long_options_orig) / sizeof(long_options_orig[0])];
+
 	{
+		size_t out = 0;
+		for (size_t lo = 0; long_options_orig[lo].name != NULL; lo++) {
+			if (long_options_orig[lo].val != 0) {
+				long_options[out++] = long_options_orig[lo];
+			}
+			long_options[out] = {0, 0, 0, 0};
+		}
+
 		for (size_t lo = 0; long_options[lo].name != NULL; lo++) {
 			if (long_options[lo].flag != NULL) {
 				if (*long_options[lo].flag != 0) {
@@ -2283,30 +2330,35 @@ int main(int argc, char **argv) {
 		default: {
 			int width = 7 + strlen(argv[0]);
 			fprintf(stderr, "Unknown option -%c\n", i);
-			fprintf(stderr, "Usage: %s", argv[0]);
+			fprintf(stderr, "Usage: %s [options] [file.json ...]", argv[0]);
-			for (size_t lo = 0; long_options[lo].name != NULL; lo++) {
+			for (size_t lo = 0; long_options_orig[lo].name != NULL && strlen(long_options_orig[lo].name) > 0; lo++) {
-				if (width + strlen(long_options[lo].name) + 9 >= 80) {
+				if (long_options_orig[lo].val == 0) {
+					fprintf(stderr, "\n  %s\n        ", long_options_orig[lo].name);
+					width = 8;
+					continue;
+				}
+				if (width + strlen(long_options_orig[lo].name) + 9 >= 80) {
 					fprintf(stderr, "\n        ");
 					width = 8;
 				}
-				width += strlen(long_options[lo].name) + 9;
+				width += strlen(long_options_orig[lo].name) + 9;
-				if (strcmp(long_options[lo].name, "output") == 0) {
+				if (strcmp(long_options_orig[lo].name, "output") == 0) {
-					fprintf(stderr, " --%s=output.mbtiles", long_options[lo].name);
+					fprintf(stderr, " --%s=output.mbtiles", long_options_orig[lo].name);
 					width += 9;
-				} else if (long_options[lo].has_arg) {
+				} else if (long_options_orig[lo].has_arg) {
-					fprintf(stderr, " [--%s=...]", long_options[lo].name);
+					fprintf(stderr, " [--%s=...]", long_options_orig[lo].name);
 				} else {
-					fprintf(stderr, " [--%s]", long_options[lo].name);
+					fprintf(stderr, " [--%s]", long_options_orig[lo].name);
 				}
 			}
 			if (width + 16 >= 80) {
 				fprintf(stderr, "\n        ");
 				width = 8;
 			}
-			fprintf(stderr, " [file.json ...]\n");
+			fprintf(stderr, "\n");
-		}
 			exit(EXIT_FAILURE);
 		}
+		}
 	}
 
 	files_open_at_start = open("/dev/null", O_RDONLY);

man/tippecanoe.1

@@ -256,6 +256,8 @@ If you don't specify, it will use \fB\fC/tmp\fR\&.
 .RS
 .IP \(bu 2
 \fB\fC\-q\fR or \fB\fC\-\-quiet\fR: Work quietly instead of reporting progress
+.IP \(bu 2
+\fB\fC\-v\fR or \fB\fC\-\-version\fR: Report Tippecanoe's version number
 .RE
 .SH Environment
 .PP

version.hpp

@@ -1 +1 @@
-#define VERSION "tippecanoe v1.17.1\n"
+#define VERSION "tippecanoe v1.17.2\n"