On Mon, 8 Sep 2014, Jonas Gorski wrote:
> http://wiki.openwrt.org/ is the community maintained documentation.
> You are welcome to add/update the documentation there.
in fact, i've already tweaked a few things there. however, while i
think wiki documentation is fine for interesting *additions* or niche
topics, i don't feel it's a replacement for a single source of
*official*, canonical documentation. so, just to clarify, there is no
actual official, currently-maintained documentation for openwrt, is
that correct?
> What you are looking for is ignoring the config, and starting from
> scratch without an existing .config, then selecting your
> target/profile with make menuconfig. Then there will be no =m
> packages selected.
*sigh* ... i'm quite familiar with the concept of configuring source
based on a kernel-style Config structure. all i wanted to know was
whether there was a separate target for building the firmware proper
without building all the optional packages. it goes without saying
that that model of compilation exists in the linux kernel, where one
can do one of:
$ make vmlinux
$ make modules
in fact, it exists in openwrt as well, where one sees the
modularization in toplevel.mk for "make download", which breaks the
downloading into convenient and logical subtasks:
download: .config FORCE
@+$(SUBMAKE) tools/download
@+$(SUBMAKE) toolchain/download
@+$(SUBMAKE) package/download
@+$(SUBMAKE) target/download
how hard would it be to define a target that builds just the firmware
without all the optional packages?
> > last question regarding docs -- are there online versions of the
> > tex docs in the docs/ directory? that would be nice so it didn't
> > require one to install all the tex-related packages just to format
> > those doc files.
>
> These are horribly outdated, just ignore that they exist. You likely
> end up with a non working system if you follow these.
at risk of offending, that's just silly. why on earth are "horribly
outdated" docs part of the checkout?
to summarize then:
* there is no official documentation for openwrt
* the current documentation is the community-maintained wiki which,
from what i've read, desperately needs updating
* the docs/ directory that is part of the repository is worthless
do i have that about right?
rday
--
========================================================================
Robert P. J. Day Ottawa, Ontario, CANADA
http://crashcourse.ca
Twitter: http://twitter.com/rpjday
LinkedIn: http://ca.linkedin.com/in/rpjday
========================================================================
_______________________________________________
openwrt-users mailing list
[email protected]
https://lists.openwrt.org/cgi-bin/mailman/listinfo/openwrt-users
