2013/7/12 Darrell Anderson > > BTW, the build notes wiki hasn't been reviewed by a newcomer in a > long time. Please offer improvements and critiques. :-) > > Darrell > Hi Darrel I've been busy with my work, but here is a quick and dirty review of the HOWTO BUILD wiki; it's based on my own selfish desires and my delusion of what I was expecting to find there, It's a 2 part review: --- There are way to many notes, really, I stopped reading them after the 4th the first time I got there! --- Prerequisites: Didn't really mention them, only say something about cmake and autotools. What about saying, when building in Debian based distributions you will need at least: aptitude install mesa3d-dev libpng-dev gcc g++ make On RedHat based distributions: yum install bla bla bla The "distribution specific build information" doesn't list the packages needed either. --- Probably only one mention of something like this would be enough: The compilation will be either with autotools or cmake, please refer to package_name/INSTALL for build instructions on each package. I'm used to checking either INSTALL or BUILDING when I don't see a configure script :) --- How about something like: At the moment PREFIX=/opt/trinity must be exported before installing some packages (like tqtinterface), please check package/INSTALL for details. And put package specific compilation options and instructions inside the README file, for example, there is no mention of --enable-closure inside tdeadmin. --- > Regenerate Autoconf/Automake files This kind of stuff should be inside each package's README or BUILDING; applies for cmake too! --- > 6. Install > make install || exit 1 A little too short to deserve a whole section don't you think? Also, that exit 1 might scare those that forget to do it as root, *cough* or didn't read the whole manual *cough* --- > 7. Build Order Finally! I'm told 2 different ways of compiling, I'm given a bunch of configuration flags and finally I know what to compile first :D Now I need to find how to compile again because I forgot D: --- > None of these Trinity libraries are required but all provide... Wait, what? what are doing another 2 dependency lists here? --- > This is not a complete list. Please help with updating the list! Interesting, here is the list of packages I need to install before compiling :) I must say the first time I didn't read this far. You could also say whether to build each package with cmake or autotools (and link to the section) --- > 9. Build Times I think this would be a good place to specify which packages support parallel building ;) Proposed wiki layout ==================== Introduction ------------ TDE is a continuation/fork/whatever of the old KDE3 desktop, it has been made so that it can coexist with other desktops like Gnome, XFCE and specially KDE4; this was achieved by renaming the TDE files. Prerequisites ------------- Packages! And probably some exports like qt3 path and stuff. Getting the sources ------------------- You can get the latest stable release at http://... Or you can get the latest development source using git clone... *Building the bare minimum desktop* ------------------------------ _Ordered_ package specific build instructions to get a shiny new TDE desktop listing the currently installed kde4, gnome and xfce4 apps. Installing the apps ------------------- Instructions for compiling non-essential stuff like gwenview, amarok, kontact, etc. that some may desire but some may not (like those comfortable with Amarok2). Pimping the desktop ------------------- Compiling superkaramba, kdm and other set of goodies. I really appreciate the effort you are doing guys, sorry if I sounded mean, it wasn't my intention. Cheers Ismael -- Do not let me induce you to satisfy my curiosity, from an expectation, that I shall gratify yours. What I may judge proper to conceal, does not concern myself alone.