0README


July, 2005

NOTES on how to configure mac os x:
	[sent to Eric after his purchase of a pbg4]
	[reconstructed from memory and log files]

assume have available the files in the:
	Configuration directory, Code/Configuration, 
	sources directory, Code/src, 
	and in the directories under, Code/Configuration/burn-050529:
		bin, man, root

critical directories are indicated by
	"****"	definitely use or read these
	"**"	use these
	"*"	may want to look at these

../-0burn-050529
|-- 0README		****	this file
|-- bin			****	local executables, binaries and scripts
|-- mac-notes		**	directory - files that may be worth a read
|-- man			****	directory - man pages for bin executables
|-- root		****	directory - .hidden 
    `-- clone-info	****	directory - script for cloning = mkbackup
        `-- clone-050525  **	directory - files tracking run of mkbackup

 Code
 |-- Configuration	****	~/.??* configuration dot-files (bash, etc.)
 |   `--0burn-050529	****	see above
 |-- Contests
 |-- PostScript		*	worth a look
 |-- R-Scripts
 |-- Scripts		*	some of the scripts in bin 
 `-- src
     |-- [....]		*	sources for some of the  binaries in bin
     |-- [react, simplex, xtoys]   sources for binaries **not** in bin
     `-- recipes
         |-- ALT-GOURMAND	Brian Reid's alt.gourmand distribution
         |   |-- Cookbook		
         |   |-- Programs
         |   `-- Recipes
         |-- RUPLEY	**	rcbook.t modified from alt.gourmand
	 |			etc., etc. as needed to format recipes
	 |			under mac os x
	 |-- Cookbook		Rupley and alt.gourmand Cookbooks, PostScript
	 |-- Programs, etc	setup for test of recipe software


SUGGEST following be done, approximately in order given:


* create your own account first - it becomes default sysadmin acct.
	[in the following, I assume your acct/login name is "eric"]


* create a root account - 
	may be needed in case of a serious crash;
	for convenience, same password as your own acct;
	root needed/useful when making backups == exact clones that boot.


* install config files in home directory:
	cd to directory "filepath.../Configuration";
	test that have files in scope:
		ls -l ./.[!D][!S]??*
	look over the dot-files:
		it should do no harm if one installs them as-is,
		but better to be aware of what's there:
		an implied directory structure, downloads from fink, etc.
	if all ok, then install them, except for .DStore:
		cp -p ./.[!D][!S]??* /Users/eric


* bring up X11 window:
	mac finder > Applications - double click on "X11";
	if you get a nice blue window, std size, then all probably ok;
	if you do not, try another mac app -  from  finder in Applications:
		Terminal
	if blue - ok; if not try setting default shell as "/bin/bash"
	if still not ok, then work with whatever window you have, as 
	need cli to configure (and to solve any X11 problem).


* if X11 window did not come up nicely configured, the problem may be
a broken startx script - check this:
	startx script (used to bring up X11) broken in 10.3 compile:
		delete top line if it reads: #pragma GCC ....
			see man X
			may not be a problem at this time


* install directory "filepath.../burn-050529/bin" (with all files 
and directories in it) in your home directory, as /Users/eric/bin;
	"bin" directory has the scripts and binaries I use,
	i.e., those in src, Scripts, etc., directories;


* install man pages for stuff in "bin": 
	install correponding "filepath.../burn-050529/man" hierarchy at
		/Users/eric/man
	after install man pages
		rework whatis database, so can use man pages and apropos;
		see manpage "makewhatis";
		need to set MANPATH in bash setup.


* install directory "clone-info" (and files and directories below it) in 
the root directory, as /clone-info;
	"clone-info" is under "filepath.../0burn-050529/root";
	must use sysadmin permissions to install in root:
		sudo cp -pR filepath.../0burn-050529/root/clone-info /
	when want to backup:
		read NOTE[12] - explanation of backup script and its use;
		rework "ex_rsync1" and "ex_rsync2" which exclude files 
			from backup - understand why want to
			exclude/include and note that "ex_rsync2"
			is irrelevant if you do not use nfs file
			sharing.
		rework a few (very few) lines in "mkbackup"


* if you are going to network labtop via ethernet/wireless:
	for easy login etc
		set up Xauthority, etc., on all machines to be linked;
	some configuration required on mac, to start demons
			/etc/xinetd.d/etc/xinetd.d
		and other stuff
	for file sharing
		set up nfs/whatever - not easy unless buy config software
		from 3rd party;

	IMPORTANT: may want to have **names** ***and*** **numbers** 
		associated with file ownership set to be the same on
		all machines on which files are to be transparently shared,
		i.e., if when logged into one machine, want to
		manipulate files as though logged onto other machine;
		if ownership names/numbers, do it when first set up accts.
	

* lots of convenience configuration:
	dock on right side, with apps you most use, browser sites most
		visited, etc.
	minimal stuff on desktop

	mail setup
	browser setup
	printer setup
	.....

	you may want to change some configuration options for hidden files
		delete or modify /.hidden
		change default dir searched and displayed by finder app
			e.g., after command-F, set search for specific
			places, specifically "bin" and "I",
			and display hidden files == dot-files

	use mac os utilities to do much of config work that would be done
	with /etc/config.... files
		netinfo
		preferences > ....
		...

	watch size of main Trash file, and empty before size >> GB


* do, or consider executing, the following cli commands:

        defaults write com.apple.finder AppleShowAllFiles 1
                so show all files, incl. those in dot-files, in  Finder:

	defaults write com.apple.X11 wm_ffm true
                maybe do not want - focus follows mouse for x11 windows 

	defaults write com.apple.Safari IncludeDebugMenu 1
                installs debug menu in safari
			useful - e.g. importing bookmarks


* bring over software, binaries if possible, in addition to what is
installed in ~/bin:

	fink binaries:
		pstree
		tree
		psutils
		fortune
		lynx
		gv 	note: gv essential for display of postscript 
			in (CLI) window directly, rather than from
			finder after conversion to pdf;

	binaries from wherever if not on fink:
	  i-installer/TeXShop, opendarwin, gnudarwin, sourceforge, 
	  http://www.apple.com/downloads/macosx/unix_open_source/, etc.

	     high priority:
                xv - I use it for jpg etc under cli - but not needed
		R - from gnu R org - general math/graph pgm
		bvi - look at binaries, etc. 
		menumeters - NICE! for top bar
		lsmac, cpmac - list, copy files with old macos forks;
			lsmac is needed for tracking files produced by
			some commercial programs, e.g., adobe
		aspell - if you compose text in vi 

	     lower priority:
		netcat - for amusement == proto-hacking
		colordiff - if you use diff
		Xaos: tutorial/display Mandelbrot set + more - NICE!
		TeXshop - nice, even if you don't do TeX
		kismac - sniffer for wireless ap
		gs - ghostscript - maybe, but perhaps not needed if have gv

	mozilla/firefox/whatever as 2nd browser (and possibly mail agent
	also)

	nfsmanager - purchased commercial prog, as I remember

	microsoft office - needed if pbg4 main machine

	IOXPerts - commercial - if want to use wireless card other than
		airport


* if questions, may find answers in files under 0burn-050529/mac-notes.

	look at:
		mac-done-summary   	notes on the configuration process

		mac-comments		pros and cons of mac pbg4

	probably ignore:
		mac-apps-demo	show what mac laptop can do - 
					biophysics oriented
		mac-intel.txt	script that when executed gives too much 
					information; 
					used when making decision to buy pbg4
		mac-todo	current todo file - 
					notes for my use
		LOG		current system log file - 
					very long and detailed descriptions;
					chronological


J. A. Rupley
rupley@u.arizona.edu

