Buildroot Archive on lore.kernel.org
 help / color / mirror / Atom feed
From: Yann E. MORIN <yann.morin.1998@free.fr>
To: buildroot@busybox.net
Subject: [Buildroot] [PATCH 23/25 v6] doc/asciidoc: always use UTC
Date: Thu, 2 Oct 2014 21:14:08 +0200	[thread overview]
Message-ID: <20141002191408.GA19775@free.fr> (raw)
In-Reply-To: <CAAXf6LU2KNsD4N9_XnTiwbKT8VRDdBZMk1Knkvm-V87q_s3HDQ@mail.gmail.com>

Thomas, All,

On 2014-10-02 12:21 +0200, Thomas De Schampheleire spake thusly:
> On Sat, Sep 27, 2014 at 12:16 PM, Yann E. MORIN <yann.morin.1998@free.fr> wrote:
[--SNIP--]
> > Just force the timezone to be UTC when doing the rendering of the
> > manual, so we are not dependent on the machine or user doign the
> 
> doing

Fixed.

> > rendering.
> >
> > Signed-off-by: "Yann E. MORIN" <yann.morin.1998@free.fr>
> > Cc: Samuel Martin <s.martin49@gmail.com>
> > Cc: Thomas De Schampheleire <patrickdepinguin@gmail.com>
> > ---
> >  package/doc-asciidoc.mk | 2 ++
> >  1 file changed, 2 insertions(+)
> >
> > diff --git a/package/doc-asciidoc.mk b/package/doc-asciidoc.mk
> > index 6185982..04c6299 100644
> > --- a/package/doc-asciidoc.mk
> > +++ b/package/doc-asciidoc.mk
> > @@ -93,6 +93,8 @@ define $(2)_$(4)_INSTALL_CMDS
> >  endef
> >  endif
> >
> > +$$(O)/docs/$(1)/$(1).$(6): export TZ=UTC
> > +
> >  ifeq ($(6)-$$(GENDOC_XSLTPROC_IS_BROKEN),pdf-y)
> >  $$(O)/docs/$(1)/$(1).$(6):
> >         $$(warning PDF generation is disabled because of a bug in \
> > --
> > 1.9.1
> >
> 
> Although I don't mind such a change, I fail to understand the use case
> here. Is this only regarding the printed date at the beginning of the
> manual?

Yes, that's about that. What bothers me is potential for inconsistency.
Also, for something that is world-readable, I usually prefer to read
dates that are not tainted by any local, user-specific timezone. UTC is
a the reference time, so I believe it is better lookign to see UTC than
any other timezone.

Indeed, it's just a trivial (as in: not important) change.

Thanks! :-)

Regards,
Yann E. MORIN.

-- 
.-----------------.--------------------.------------------.--------------------.
|  Yann E. MORIN  | Real-Time Embedded | /"\ ASCII RIBBON | Erics' conspiracy: |
| +33 662 376 056 | Software  Designer | \ / CAMPAIGN     |  ___               |
| +33 223 225 172 `------------.-------:  X  AGAINST      |  \e/  There is no  |
| http://ymorin.is-a-geek.org/ | _/*\_ | / \ HTML MAIL    |   v   conspiracy.  |
'------------------------------^-------^------------------^--------------------'

  reply	other threads:[~2014-10-02 19:14 UTC|newest]

Thread overview: 55+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2014-09-27 10:16 [Buildroot] [pull request v6] gendoc infra: make it useable for other documents Yann E. MORIN
2014-09-27 10:16 ` [Buildroot] [PATCH 01/25 v6] gendoc infra: move manual build location into $(BUILD_DIR)/manual Yann E. MORIN
2014-09-27 10:16 ` [Buildroot] [PATCH 02/25 v6] gendoc infra: avoid a2x warning Yann E. MORIN
2014-09-27 10:16 ` [Buildroot] [PATCH 03/25 v6] gendoc infra: disable pdf manual generation if xsltproc is buggy Yann E. MORIN
2014-09-27 10:16 ` [Buildroot] [PATCH 04/25 v6] docs/manual: get rid of legacy comment in GENDOC Yann E. MORIN
2014-09-27 10:16 ` [Buildroot] [PATCH 05/25 v6] docs/manual: copying the manual sources is a common action Yann E. MORIN
2014-09-27 10:16 ` [Buildroot] [PATCH 06/25 v6] docs/manual: simplify generation dependencies Yann E. MORIN
2014-09-27 10:16 ` [Buildroot] [PATCH 07/25 v6] docs/manual: manual-update-lists is not a generic GENDOC rule Yann E. MORIN
2014-09-27 10:16 ` [Buildroot] [PATCH 08/25 v6] docs/manual: move manual-prepare-sources rule into GENDOC Yann E. MORIN
2014-09-27 10:16 ` [Buildroot] [PATCH 09/25 v6] docs/manual: do not hardcode name of the generated document Yann E. MORIN
2014-09-29 19:33   ` Thomas De Schampheleire
2014-09-29 20:01     ` Yann E. MORIN
2014-09-29 20:09       ` Thomas De Schampheleire
2014-09-29 20:26         ` Yann E. MORIN
2014-10-09 22:22           ` Arnout Vandecappelle
2014-09-27 10:16 ` [Buildroot] [PATCH 10/25 v6] docs/manual: allow a document to declare where its resources are Yann E. MORIN
2014-09-27 11:20   ` Samuel Martin
2014-09-29 19:35   ` Thomas De Schampheleire
2014-09-27 10:16 ` [Buildroot] [PATCH 11/25 v6] docs/manual: last pass at removing hard-coded path in GENDOC_INNER Yann E. MORIN
2014-09-27 11:20   ` Samuel Martin
2014-09-27 10:16 ` [Buildroot] [PATCH 12/25 v6] docs/manual: properly separate rules specific for our manual Yann E. MORIN
2014-09-27 11:20   ` Samuel Martin
2014-09-27 10:16 ` [Buildroot] [PATCH 13/25 v6] docs/manual: rename the generic dependency rules Yann E. MORIN
2014-09-27 10:16 ` [Buildroot] [PATCH 14/25 v6] docs/manual: allow documents to define some hooks, as for a package Yann E. MORIN
2014-10-01 19:58   ` Thomas De Schampheleire
2014-09-27 10:16 ` [Buildroot] [PATCH 15/25 v6] docs/manual: use the new hooks instead of gendoc rules Yann E. MORIN
2014-10-01 20:00   ` Thomas De Schampheleire
2014-09-27 10:16 ` [Buildroot] [PATCH 16/25 v6] docs/manual: always look for resources in destination directory Yann E. MORIN
2014-10-01 20:01   ` Thomas De Schampheleire
2014-09-27 10:16 ` [Buildroot] [PATCH 17/25 v6] docs: separate the GENDOC infra from our manual definition Yann E. MORIN
2014-09-27 11:20   ` Samuel Martin
2014-09-27 10:16 ` [Buildroot] [PATCH 18/25 v6] docs: rename the GENDOC infrastructure Yann E. MORIN
2014-10-01 20:02   ` Thomas De Schampheleire
2014-09-27 10:16 ` [Buildroot] [PATCH 19/25 v6] docs/asciidoc: call $(pkgname) and $(pkgdir) in a single place Yann E. MORIN
2014-10-01 20:03   ` Thomas De Schampheleire
2014-09-27 10:16 ` [Buildroot] [PATCH 20/25 v6] docs/asciidoc: make it possible to use $(@D) in hooks Yann E. MORIN
2014-10-02  9:45   ` Thomas De Schampheleire
2014-09-27 10:16 ` [Buildroot] [PATCH 21/25 v6] doc/asciidoc: allow documents to pass a global asciidoc configuration Yann E. MORIN
2014-09-27 11:20   ` Samuel Martin
2014-09-27 12:51     ` Yann E. MORIN
2014-10-02  9:50   ` Thomas De Schampheleire
2014-09-27 10:16 ` [Buildroot] [PATCH 22/25 v6] doc/asciidoc: always apply Buildroot's AsciiDoc config Yann E. MORIN
2014-09-27 11:21   ` Samuel Martin
2014-09-27 12:56     ` Yann E. MORIN
2014-10-02 10:17   ` Thomas De Schampheleire
2014-10-02 21:46     ` Yann E. MORIN
2014-09-27 10:16 ` [Buildroot] [PATCH 23/25 v6] doc/asciidoc: always use UTC Yann E. MORIN
2014-10-02 10:21   ` Thomas De Schampheleire
2014-10-02 19:14     ` Yann E. MORIN [this message]
2014-09-27 10:17 ` [Buildroot] [PATCH 24/25 v6] Makefile: enable generating documents from br2-external Yann E. MORIN
2014-09-27 10:17 ` [Buildroot] [PATCH 25/25 v6] docs/manual: document the asciidoc infra Yann E. MORIN
2014-09-27 11:21   ` Samuel Martin
2014-09-27 12:40     ` Yann E. MORIN
2014-10-02 10:27   ` Thomas De Schampheleire
2014-10-02 19:20     ` Yann E. MORIN

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

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20141002191408.GA19775@free.fr \
    --to=yann.morin.1998@free.fr \
    --cc=buildroot@busybox.net \
    /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.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox