From: Ulf Stegemann <ulf-news@zeitform.de>
To: emacs-orgmode@gnu.org
Subject: Re: [BUG] HTML exporting numbered literal examples
Date: Fri, 17 Jul 2009 23:08:26 +0200 [thread overview]
Message-ID: <zf.upnljmnhvat.fsf@zeitform.de> (raw)
In-Reply-To: 87y6qn9xed.fsf@bzg.ath.cx
Bastien <bastienguerry@googlemail.com> wrote:
> Ulf Stegemann <ulf-news@zeitform.de> writes:
>
>> I had a quick look at `org-export-number-lines' and the following seems
>> to work smoothly ...
>
> Thanks for the patch. One problem though: now the first link (from the
> manuals example) looks like "sc" but there is no "sc" left in the source
> code. This is a bit confusing, no? So if we plan to make references to
> lines of code, it make sense to have either the line numbering or the
> labels (or both). What do you think?
Right, I agree with your observation but I think I wouldn't with your
conclusion. I don't think that this is a problem. From the author's
point of view I think he/she knows what's going on since this is not the
default behaviour and the `-r' switch actually has to be added. And
after all we are talking about links. And as with any other link if the
link target is self-explanatory: fine, then I can use it as link name. If
it is not, I should choose something less confusing for the reader.
Translated to the situation we have here this means: I can choose a
self-explanatory reference and use this or I can give the link a label
with a clear indication of what the link is about.
From the reader's point of view there's no confusion either because
he/she can always follow the link and see where this leads.
I absolutely second that confusing behaviour should be avoided whenever
possible but I don't think any confusion will occur here.
Ulf
next prev parent reply other threads:[~2009-07-17 21:08 UTC|newest]
Thread overview: 10+ messages / expand[flat|nested] mbox.gz Atom feed top
2009-07-09 10:44 [BUG] HTML exporting numbered literal examples Ulf Stegemann
2009-07-16 19:43 ` Bastien
2009-07-17 10:10 ` Ulf Stegemann
2009-07-17 14:50 ` Bastien
2009-07-17 21:08 ` Ulf Stegemann [this message]
2009-07-18 7:15 ` Bastien
2009-07-20 11:36 ` Ulf Stegemann
2009-07-23 19:58 ` Bastien
2009-07-24 6:38 ` Ulf Stegemann
2009-08-03 4:27 ` Carsten Dominik
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=zf.upnljmnhvat.fsf@zeitform.de \
--to=ulf-news@zeitform.de \
--cc=emacs-orgmode@gnu.org \
/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).