From 034d6e811fdfeb91e19a013e63d3d2ec463f5a8c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?R=C3=A9mi=20Verschelde?= <rverschelde@gmail.com>
Date: Tue, 26 Apr 2016 21:35:06 +0200
Subject: [PATCH] Various improvements to doc_status.py

- Make comments opt-in (smaller table in width)
- Reduce length of Brief Description and Description (also smaller table as output)
- Make names cyan (blue is too dark on black terminal)
- Drop some redundant synonyms for the flags
---
 doc/tools/doc_status.py | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/doc/tools/doc_status.py b/doc/tools/doc_status.py
index 5faee570d80..35a6bc8bc44 100755
--- a/doc/tools/doc_status.py
+++ b/doc/tools/doc_status.py
@@ -14,6 +14,7 @@ flags = {
 	'c': platform.platform() != 'Windows', # Disable by default on windows, since we use ANSI escape codes
 	'b': False,
 	'g': False,
+	's': False,
 	'u': False,
 	'h': False,
 	'p': False,
@@ -24,6 +25,7 @@ flag_descriptions = {
 	'c': 'Toggle colors when outputting.',
 	'b': 'Toggle showing only not fully described classes.',
 	'g': 'Toggle showing only completed classes.',
+	's': 'Toggle showing comments about the status.',
 	'u': 'Toggle URLs to docs.',
 	'h': 'Show help and exit.',
 	'p': 'Toggle showing percentage as well as counts.',
@@ -32,7 +34,6 @@ flag_descriptions = {
 }
 long_flags = {
 	'colors': 'c',
-	'color': 'c',
 	'use-colors': 'c',
 
 	'bad': 'b',
@@ -41,29 +42,27 @@ long_flags = {
 	'good': 'g',
 	'only-good': 'g',
 
+	'comments': 's',
+	'status': 's',
+
 	'urls': 'u',
-	'url': 'u',
-	'generate-urls': 'u',
 	'gen-url': 'u',
 
 	'help': 'h',
 
 	'percent': 'p',
-	'percentages': 'p',
 	'use-percentages': 'p',
 
 	'overall': 'o',
 	'use-overall': 'o',
 
 	'items': 'i',
-	'collapse-items': 'i',
 	'collapse': 'i',
-	'narrow': 'i',
 }
 table_columns = ['name', 'brief_description', 'description', 'methods', 'constants', 'members', 'signals']
-table_column_names = ['Name', 'Brief Description', 'Description', 'Methods', 'Constants', 'Members', 'Signals']
+table_column_names = ['Name', 'Brief Desc.', 'Desc.', 'Methods', 'Constants', 'Members', 'Signals']
 colors = {
-	'name': [34], # blue
+	'name': [36], # cyan
 	'part_big_problem': [4, 31], # underline, red
 	'part_problem': [31], # red
 	'part_mostly_good': [33], # yellow
@@ -201,11 +200,12 @@ class ClassStatus:
 
 		if self.name.startswith('Total'):
 			output['url'] = color('url', 'http://docs.godotengine.org/en/latest/classes/_classes.html')
-			output['comment'] = color('part_good', 'ALL OK')
+			if flags['s']:
+				output['comment'] = color('part_good', 'ALL OK')
 		else:
 			output['url'] = color('url', 'http://docs.godotengine.org/en/latest/classes/class_{name}.html'.format(name=self.name.lower()))
 
-			if not flags['g'] and self.is_ok():
+			if flags['s'] and not flags['g'] and self.is_ok():
 				output['comment'] = color('part_good', 'ALL OK')
 
 		return output