From: "Eric Schulte" <schulte.eric@gmail.com>
To: Jambunathan K <kjambunathan@gmail.com>
Cc: "Eric M. Ludlam" <eric@siege-engine.com>,
Lennart Borgman <lennart.borgman@gmail.com>,
Konrad Scorciapino <scorciapino@gmail.com>,
Carsten Dominik <carsten.dominik@gmail.com>,
Org Mode <emacs-orgmode@gnu.org>,
cedet-devel@lists.sourceforge.net
Subject: Re: Re: [CEDET-devel] Org-mode
Date: Thu, 04 Nov 2010 13:16:03 -0600 [thread overview]
Message-ID: <874obwsxvw.fsf@gmail.com> (raw)
In-Reply-To: <8139rht16z.fsf@gmail.com> (Jambunathan K.'s message of "Thu, 04 Nov 2010 23:34:36 +0530")
Jambunathan K <kjambunathan@gmail.com> writes:
> The main challenge with breaking up org-html.el first and then say
> plugging in org-odt.el to that later is:
>
> 1. Code-churn that it would create in org-html.el
> 2. Proving that *nothing* in HTML export actually breaks.
>
> Carsten would like to avoid (1) - he might want to go with one bit
> commit and (naturally) shift the responsibility of (2) to the committer.
>
> So a committer has one more thing he needs to be concerned about.
>
> I do see some regression tests for html exporter and I am unsure how
> *complete* they are. What would have really made things easier is the
> following:
>
I don't believe that there are any existing unit tests for the org html
exporter, however writing a suite of such tests seems like the best
first step in this project. It would allow sanity checks throughout the
implementation of the parser, and would give some confidence in the
parsers functionality before merging back into the core.
Org-mode has a test suite based around ERT, which should facilitate this
process. Look in the testing directory of the Org-mode repository.
>
> 1. One Org file in repo that has *all* the Org-specific markups.
Yes, either one large file or many smaller files. For the Babel tests
we use one large file with one subtree per test s.t. it is easy for a
specific test to jump to the appropriate section of the file.
>
> 2. One HTML file that is a exported from this Org file which is
> re-checked in as and when the org-html.el changes it's markups.
>
> Everytime something changes in the exporter one just diffs the *new*
> HTML file with the one in the repo and be able to say with assured
> confidence that something has improved or broken.
>
I think a series of feature specific unit tests would provide more
granular feedback, would allow incremental development, and would allow
differences in non-essential properties like white-space.
Best -- Eric
prev parent reply other threads:[~2010-11-04 19:17 UTC|newest]
Thread overview: 7+ messages / expand[flat|nested] mbox.gz Atom feed top
[not found] <AANLkTinWfjJ_t=1E8=Xmy2T+dThzC9N8wBoKj+Nw7XS9@mail.gmail.com>
[not found] ` <4CD15272.2080303@siege-engine.com>
2010-11-03 12:34 ` Org-mode Lennart Borgman
2010-11-04 14:37 ` Re: [CEDET-devel] Org-mode Carsten Dominik
2010-11-04 15:45 ` [Orgmode] Org-mode Lennart Borgman
2010-11-04 15:50 ` Re: [CEDET-devel] Org-mode Carsten Dominik
2010-11-04 18:04 ` Jambunathan K
2010-11-04 18:44 ` [Orgmode] Org-mode Lennart Borgman
2010-11-04 19:16 ` Eric Schulte [this message]
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: https://www.orgmode.org/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=874obwsxvw.fsf@gmail.com \
--to=schulte.eric@gmail.com \
--cc=carsten.dominik@gmail.com \
--cc=cedet-devel@lists.sourceforge.net \
--cc=emacs-orgmode@gnu.org \
--cc=eric@siege-engine.com \
--cc=kjambunathan@gmail.com \
--cc=lennart.borgman@gmail.com \
--cc=scorciapino@gmail.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).