Codebase list lua-ldoc / 55bbeed
added module merging - see tests/merge directory (--merge flag) steve donovan 11 years ago
6 changed file(s) with 41 addition(s) and 1 deletion(s). Raw diff Collapse all Expand all
214214 if item.type == 'module' then
215215 -- if name is 'package.mod', then mod_name is 'mod'
216216 package,mname = split_dotted_name(this_mod.name)
217 if self.args.merge then
218 local mod,mf = find_module_in_files(item.name)
219 if mod then
220 print('found master module',mf)
221 this_mod = mod
222 submodule = true
223 end
224 end
217225 elseif item.type == 'submodule' then
218226 local mf
219227 submodule = true
148148 local F = File(fname)
149149 local module_found, first_comment = false,true
150150 local current_item, module_item
151
152 F.args = args
151153
152154 F.base = package
153155
5454 -D,--define (default none) set a flag to be used in config.ld
5555 -C,--colon use colon style
5656 -B,--boilerplate ignore first comment in source files
57 -M,--merge allow module merging
5758 --dump debug output dump
5859 --filter (default none) filter output as Lua data (e.g pl.pretty.dump)
5960 --tags (default none) show all references to given tags, comma-separated
180181 'alias','add_language_extension','new_type','add_section', 'tparam_alias',
181182 'file','project','title','package','format','output','dir','ext', 'topics',
182183 'one','style','template','description','examples',
183 'readme','all','manual_url', 'ignore', 'colon','boilerplate',
184 'readme','all','manual_url', 'ignore', 'colon','boilerplate','merge',
184185 'no_return_or_parms','no_summary','full_description','backtick_references', 'custom_see_handler',
185186 }
186187 ldoc_contents = tablex.makeset(ldoc_contents)
347348 setup_package_base()
348349
349350 override 'colon'
351 override 'merge'
350352
351353 if type(args.file) == 'table' then
352354 -- this can only be set from config file so we can assume it's already read
0 merge=true
1 file={'merge1.lua','merge2.lua'}
0 ----
1 -- main module
2 -- @module merge
3
4 ---- first fun
5 function one()
6 end
0 ----
1 -- submodule
2 -- @module merge
3
4 ---- second fun
5 -- @param x
6 function two(x)
7 end
8
9 --- extra stuff
10 -- @section extra
11
12 --- third fun
13 function three ()
14 end
15
16 --- fourth fun
17 function four ()
18 end