stmhal, docs: Small changes to URL links; adds list of files if none given.

dpgeorge · dpgeorge · commit f4b7e9bd2e72 · 2014-04-30T23:33:30.000+01:00
This documentation is now available at micropython.org/doc/
diff --git a/stmhal/gendoc.py b/stmhal/gendoc.py
@@ -230,7 +230,7 @@ def dump(self):
         s.append('## Classes')
         for c in sorted(self.classes.values(), key=lambda x:x.name):
             s.append('')
-            s.append('[`{}.{}`]({}/index.html) - {}'.format(self.name, c.name, c.name, c.descr))
+            s.append('[`{}.{}`]({}) - {}'.format(self.name, c.name, c.name, c.descr))
         return '\n'.join(s)
 
     def write(self, dir):
@@ -241,7 +241,7 @@ def write(self, dir):
             class_dir = os.path.join(dir, c.name)
             makedirs(class_dir)
             class_dump = c.dump()
-            class_dump = 'part of the [{} module](../index.html)'.format(self.name) + '\n' + class_dump
+            class_dump = 'part of the [{} module](./)'.format(self.name) + '\n' + class_dump
             index = markdown.markdown(class_dump)
             with open(os.path.join(class_dir, 'index.html'), 'wt') as f:
                 f.write(index)
@@ -272,9 +272,7 @@ def process_moduleref(self, lex, d):
         if name not in self.modules:
             lex.error('module {} referenced before definition'.format(name))
         self.cur_module = self.modules[name]
-
-    #def process_classref(self, lex, d):
-    #    self.cur_module.process_classref(lex, d)
+        lex.opt_break()
 
     def process_class(self, lex, d):
         self.check_module(lex)
@@ -341,9 +339,12 @@ def process_file(file, doc):
 def main():
     cmd_parser = argparse.ArgumentParser(description='Generate documentation for pyboard API from C files.')
     cmd_parser.add_argument('--outdir', metavar='<output dir>', default='gendoc-out', help='ouput directory')
-    cmd_parser.add_argument('files', nargs='+', help='input files')
+    cmd_parser.add_argument('files', nargs='*', help='input files')
     args = cmd_parser.parse_args()
 
+    if len(args.files) == 0:
+        args.files = ['modpyb.c', 'accel.c', 'adc.c', 'dac.c', 'extint.c', 'i2c.c', 'led.c', 'pin.c', 'rng.c', 'servo.c', 'spi.c', 'uart.c', 'usrsw.c']
+
     doc = Doc()
     for file in args.files:
         print('processing', file)
