We originally had separate installation instructions for the base system and the installation of the Qt IDE.
I think it is best this way. There is far too much information to be on a single page, and this complicates things. It is already a large page, and even now not all the information has been copied over from the Qt install page. Moreover, the end user should understand that the base system and IDE are different things. After all, many users don't even install the Qt IDE, but use JHS or the console. This understanding also helps when updating the system. So I suggest that we have separate instructions for the base system, instructions for the Qt IDE, and instructions for addons. There is no harm in pointing to the Windows AIO installers in the instructions for the base system as doing the first two of these. What would solve Henry's problem with schoolchildren is a quick start guide for Windows that describes how to install a full Jqt system with all addons starting with an AIO installer. This could point to the detailed instruction pages for anyone wanted to customize the system in some way. On 3 August 2015 at 06:17, Henry Rich <[email protected]> wrote: > Thanks, guys, I have a new version up that addresses the issues raised by > Bill and Brian (except that I still call for use of Package Manager because > I think having them start Jconsole is more confusing). > > I still need expert help in 2 areas: > > 1. Under (optional) Install the Qt IDE there is a reference to the name > of the program under Windows but not under other OSs. What should that > name be? > > 2. The instructions for installing on the Mac are not easy enough to use. > Some of my students are 14-year-old girls with no computer experience and > they have to get J installed. Can somebody write a sequence of steps that > they can understand? > > Henry > > > On 8/2/2015 8:51 PM, Brian Schott wrote: > >> I note that most references in the current jwiki page are to Qt IDE, but >> occasionally the term jqt is used, as a synonym, without a formal >> connection being made. I think that should be fixed. >> >> >> I also note that the reference link to Package manager is at the anchor >> #install which is a little jarring to see pop up. As a matter of fact for >> a >> beginner I think the task of requiring the use of Package manager is very >> off-putting, and that leads to my next question, below. >> >> Under the Mac installation mention is made of "install 'all'" from >> jconsole. What does this do and would it be a good alternative for >> beginners of ALL platforms who want to experiment without having to read >> all of these instructions carefully? >> >> >> For example is the JFE JHS always installed on all platforms, and if so >> why >> is it not mentioned in the "What is installed" section? >> >> Bill has added some other comments that must be answered before this jwiki >> page is taken out of Beta, imo. >> >> Clearly, I am a little confused about Henry's request that I write a >> section. But I offer the text below as a partial draft. >> >> ************* >> >> What is not installed >> >> The next session covers the installation of "packages" which is the main >> omission in the installation on all platforms. "Packages" are often >> called >> "Libraries" elsewhere. >> >> As noted above, on some platforms, notably Windows, the Qt IDE is >> automatically installed, but in other cases another step is required for >> that installation, but both jconsole and JHS are installed automatically. >> If the Qt IDE has not been automatically installed, then it can be >> installed via the jconsole JFE as described in the link provided. >> >> >> >> On Sun, Aug 2, 2015 at 7:56 PM, Henry Rich <[email protected]> wrote: >> >> http://www.jsoftware.com/jwiki/System/Installation/J804 >>> >>> I have tried to respond to the suggestions given here by adding text >>> explaining things and adding a section focused on new users. There are >>> errors and omissions that need to be fixed by someone who knows the >>> answers: >>> >>> 1. Android is not listed under the supported platforms >>> >>> 2. There is a note in the installation page saying that jconsole is >>> renamed to ijconsole; this conflicts with the info under 'What Is >>> Installed' and later references to jconsole. >>> >>> 3. Someone who knows how to install on: >>> Mac >>> Linux >>> Android >>> Raspberry Pi >>> >>> needs to go into the 'If You Are New to J' section and list the steps for >>> those platforms. There is a lot of information under 'OS-specific >>> Information' but you'd have to be a geek to make sense of it. We need >>> some >>> simple instructions for ordinary users, especially Mac users. >>> >>> Henry Rich >>> ---------------------------------------------------------------------- >>> For information about J forums see http://www.jsoftware.com/forums.htm >>> >>> >> >> >> ---------------------------------------------------------------------- > For information about J forums see http://www.jsoftware.com/forums.htm > ---------------------------------------------------------------------- For information about J forums see http://www.jsoftware.com/forums.htm
