From 3b7e4e9726bc14571853eeb625108f53cfeb8164 Mon Sep 17 00:00:00 2001 From: KATO Tomoyuki Date: Wed, 25 Jan 2017 12:46:57 +0900 Subject: [PATCH] [cli-ref] emphasize the warning Many people doesn't notice the warning. So, I'd like to emphasize it. Change-Id: I3526acab8e908f8a321cf9b00cce737a4dfe9da2 --- os_doc_tools/commands.py | 18 ++++++++++++++++-- 1 file changed, 16 insertions(+), 2 deletions(-) diff --git a/os_doc_tools/commands.py b/os_doc_tools/commands.py index 25c9cef1..51381297 100644 --- a/os_doc_tools/commands.py +++ b/os_doc_tools/commands.py @@ -81,9 +81,23 @@ def generate_heading(os_command, api_name, title, print("Documenting '%s help (version %s)'" % (os_command, version)) os_file = open(os.path.join(output_dir, os_filename), 'w') - os_file.write(".. ## WARNING #####################################\n") + os_file.write(".. ###################################################\n") + os_file.write(".. ## WARNING ######################################\n") + os_file.write(".. ############## WARNING ##########################\n") + os_file.write(".. ########################## WARNING ##############\n") + os_file.write(".. ###################################### WARNING ##\n") + os_file.write(".. ###################################################\n") + os_file.write(".. ###################################################\n") + os_file.write(".. ##\n") os_file.write(".. This file is tool-generated. Do not edit manually.\n") - os_file.write(".. ##################################################\n\n") + os_file.write(".. http://docs.openstack.org/contributor-guide/\n") + os_file.write(".. doc-tools/cli-reference.html\n") + os_file.write(".. ##\n") + os_file.write(".. ## WARNING ######################################\n") + os_file.write(".. ############## WARNING ##########################\n") + os_file.write(".. ########################## WARNING ##############\n") + os_file.write(".. ###################################### WARNING ##\n") + os_file.write(".. ###################################################\n\n") format_heading(title, 1, os_file) if os_command == "heat":