Am 15.02.2012 20:59, schrieb François Pinard:
Andrea Crotti<andrea.crott...@gmail.com> writes:
And really, 10k lines of code is not good, in any language, because
it's impossible just have a look at the file and understand (even very
approximatively) what is going on.
Hi, Andrea.
I really believe that there are ways to organize and document a big file
so it is clear, legible, and manageable.
updated doc/commands-python-mode.org
which should deliver some overview.
It all depends on the code. Gnus or Org could not be bundled as a
single file. Next to these, Python mode is still a tiny thing.
Splitting a small project in parts might augment the editing hurdle. If
the original file is disorganised, splitting it might organise it a bit,
but overall, this would only very marginally improve it.
If there is a problem in the area of clarity and legibility, splitting
is really not going to solve it in a significant way. This would be a
wrong approach for a real problem.
Oh, no doubt that there might be other good reasons to split. But as
far as the quality of the documentation is meant, it would not buy us
much, and might only induce useless delays.
François
_______________________________________________
Python-mode mailing list
Python-mode@python.org
http://mail.python.org/mailman/listinfo/python-mode
