On 02/07/2014 02:48, Alon Zakai wrote:
> Another thing that occurred to me is that we have inline docs in
> JavaScript as well, not just C++ (e.g., ccall in src/preamble.js). I
> suppose these tools might work on that as well? Could make things a
> little more complex though. Overall it might just be simpler to move
> the docs out of source files and into dedicated docs files.
Documentation separate from the code inevitably gets out of date very
quickly. Having the documentation and code together is obviously no
guarantee that the documentation will be updated along with the code but
it improves the chances hugely.
I urge no separation of docs and code.
Regards
-Mark
--
注意：この電子メールには、株式会社エイチアイの機密情報が含まれている場合
が有ります。正式なメール受信者では無い場合はメール複製、 再配信または情
報の使用を固く禁じております。エラー、手違いでこのメールを受け取られまし
たら削除を行い配信者にご連絡をお願いいたし ます.
NOTE: This electronic mail message may contain confidential and
privileged information from HI Corporation. If you are not the intended
recipient, any disclosure, photocopying, distribution or use of the
contents of the received information is prohibited. If you have received
this e-mail in error, please notify the sender immediately and
permanently delete this message and all related copies.
--
You received this message because you are subscribed to the Google Groups
"emscripten-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
For more options, visit https://groups.google.com/d/optout.
