public inbox for u-boot@lists.denx.de
 help / color / mirror / Atom feed
From: Detlev Zundel <dzu@denx.de>
To: u-boot@lists.denx.de
Subject: [U-Boot-Users] u-boot wiki and arch-specific details
Date: Thu, 17 Apr 2008 16:50:01 +0200	[thread overview]
Message-ID: <m2tzi0cz8m.fsf@ohwell.denx.de> (raw)
In-Reply-To: <200804141334.57715.vapier@gentoo.org> (Mike Frysinger's message of "Mon, 14 Apr 2008 13:34:57 -0400")

Hi Mike,

> On Monday 14 April 2008, Detlev Zundel wrote:
>> > we maintain a Blackfin-specific u-boot wiki that goes into quite a bit of
>> > detail, some of which is duplicated with the main u-boot wiki.  how do
>> > people feel about extending the u-boot wiki to allow for arch-specific
>> > details ?
>>
>> What exactly do you have in mind?  I surely don't see any principal
>> problem here.
>>
>> It would certainly be valuable to get all U-Boot related info collected
>> in a central place and have pointers wherever that make sense...
>
> from my reading of the wiki, it's more of a technical/command reference than a 
> guide.  the wiki we maintain is geared to be more of a guide.  i think the 
> two can be merged, i just dont want to convert things only to find out people 
> dont want to take it that direction.

Just to be clear, we are discussing the DULG wiki, right?  

I agree that in the current state the documentation is more a reference
but IIRC that wasn't really a conscious design decision.  It simply
turned out this way in the end.

So I do not see any general problem in adding "guide style" sections in
there.  Maybe then most of the current documentation can then be shifted
to a "commands reference" section.

One problem I see though is how to correctly adapt such sections to the
board specific nature of the DULG.  Hopefully we can get away with
mostly generic text passages and only a few ifdefs.  It would be very
helpful to know more concrete plans (outline!) to think further about
these implications.

Cheers
  Detlev

-- 
Applied mathematicians do it by computer simulation.
--
DENX Software Engineering GmbH,      MD: Wolfgang Denk & Detlev Zundel
HRB 165235 Munich,  Office: Kirchenstr.5, D-82194 Groebenzell, Germany
Phone: (+49)-8142-66989-40 Fax: (+49)-8142-66989-80 Email: dzu at denx.de

  reply	other threads:[~2008-04-17 14:50 UTC|newest]

Thread overview: 5+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2008-04-13 23:26 [U-Boot-Users] u-boot wiki and arch-specific details Mike Frysinger
2008-04-14 13:12 ` Detlev Zundel
2008-04-14 17:34   ` Mike Frysinger
2008-04-17 14:50     ` Detlev Zundel [this message]
2008-04-17 18:01       ` Mike Frysinger

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=m2tzi0cz8m.fsf@ohwell.denx.de \
    --to=dzu@denx.de \
    --cc=u-boot@lists.denx.de \
    /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