diff --git a/chapters/Games.tex b/chapters/Games.tex index 678b1fb5ee3e9676beacac52790efd5dd4c755be..3d7f21288cdb3d2112f3ec3e2629d9a6661fdedd 100644 --- a/chapters/Games.tex +++ b/chapters/Games.tex @@ -3,11 +3,10 @@ Do you like Steam? Of course you do! Join UCC's Steam Group: \url{http://steamcommunity.com/groups/UCC} \noindent UCC runs its own TF2, WolfET and Minecraft servers. -There are also a range of other games that members enjoy playing in the clubroom. Here is a summary. +There's also a range of other games that members enjoy playing in the clubroom. \section{Minecraft} - -Minecraft is a game where you mine blocks and craft things out of them. It is more exciting than it sounds. Within 5 minutes you will be addicted. But you probably already know this. +Minecraft is a game where you mine blocks and craft things out of them. It is more exciting than it sounds - within 5 minutes you will be addicted. Our (modded) Minecraft server is at \shell{minecraft.ucc.asn.au}. The modpack changes every three to six months, so you will never get bored! For more instructions, visit \url{http://minecraft.ucc.asn.au/ucc}. You can also find maps of the world there. %\figref{minecraft_pigmap.png}. @@ -21,11 +20,9 @@ For more instructions, visit \url{http://minecraft.ucc.asn.au/ucc}. You can also \end{comment} \section{WolfET} - Wolfenstein: Enemy Territory, (or just ET) is an old game but is still incredibly popular at LANs. There is a scholarship \seeref{camp_scholarship} available for the camp which requires playing ET. The ET server is at \server{heathred.ucc.asn.au}. \section{TF2} - Team Fortress 2, also known as Hat Fortress 2. The TF2 server is located at \shell{heathred.ucc.asn.au}. \begin{comment} @@ -37,11 +34,8 @@ Team Fortress 2, also known as Hat Fortress 2. The TF2 server is located at \she \end{figure} \end{comment} - \section{DoTa} - DoTa is a game that involves a lot of clicking and people yelling about 'Q's and 'W's and 'alties'. Apparently it's fun. UCC doesn't run its own server but it is the most popular game in the clubroom. Unless that's LoL. I can't tell the difference. \section{LoL} - LoL is a game similar to DoTa but not the same because it is different. diff --git a/chapters/Glossary.tex b/chapters/Glossary.tex index 299168cbb05dbfd409324e52d4ec4a1fc8018c2c..c3bb8e37388a0077e95c92a0ce52beb92e2ee89e 100644 --- a/chapters/Glossary.tex +++ b/chapters/Glossary.tex @@ -3,6 +3,10 @@ \rowcolors{1}{}{lightgray} \small{ +% Whenever a chapter is started with a figure or table, it forces a blank page? +% -> Add some text +what is this i don't even + \begin{tabular}{p{0.2\linewidth}|p{0.7\linewidth}} \rowcolor{black} \color{white}{Term} & \color{white}{Translation} \\ Dr ACC Murphy & @@ -18,7 +22,7 @@ The people who can put money (Coke credit) in your dispense account. \\ Debian & a Linux distribution popular in the UCC due to its community nature. \\ DEC Terminal & -A dumb serial terminal, useful for plugging into the serial console on servers (possibly via a terminal server). Has a model number like vt100, vt200 or vt420. There's one in the corridor you can log into \server{mussel} and dispense drinks from. \\ +A dumb serial terminal, useful for plugging into the serial console on servers (possibly via a terminal server). Has a model number like vt100 or vt420. There's one in the corridor you can log into \server{mussel} and dispense drinks from. \\ dispense & dispense started off as a way to dispense Cokes from the online Coke machine, and has since grown into the way UCCans think the world should do business. \\ Door Group & @@ -31,8 +35,8 @@ Fresher & A new university student, usually also a first time UCC member. \\ Fresher Rep & Fresher Committee member, usually chosen because they look like they'll make a good worker drone in the future. Represents the freshers at committee meetings, if they attend. \\ -GNOME & -GNU Networked Object Model Environment -- an open source desktop environment aimed primarily at UNIX computers. Quite popular in the past, before it removed all of the features people liked. \\ +%GNOME & +%GNU Networked Object Model Environment -- an open source desktop environment aimed primarily at UNIX computers. Quite popular in the past, before it removed all of the features people liked. \\ GNU & GNU is Not Unix -- a layer of libraries and utilities to implement a UNIX like operating system, commonly used on top of Linux. \\ \end{tabular}} @@ -47,8 +51,8 @@ Internet Explorer & Just use Firefox. No, really. \\ IRC & The lifeblood of UCCan communication. Internet Relay Chat lets you share news, stories and terrible puns with other members worldwide. \\ -KDE & -The K Desktop Environment. A rival of GNOME which some members prefer. Contains a frankly scary number of features, and a memory footprint to match. \\ +%KDE & +%The K Desktop Environment. A rival of GNOME which some members prefer. Contains a frankly scary number of features, and a memory footprint to match. \\ kernel & The core of an operating system. All operating systems have a kernel, some popular ones include the Linux kernel and the Mach kernel. \\ LDAP & @@ -70,8 +74,8 @@ boots more then one operating system (selectable when you boot). These all end u OpenSolaris & A UNIX developed by Sun Microsystems, and abandoned by Oracle. \\ -NeXTStep & -An operating system developed by NeXT before they were bought out by Apple. Lots of NeXTStep is incorporated into Mac OS X. \\ +%NeXTStep & +%An operating system developed by NeXT before they were bought out by Apple. Lots of NeXTStep is incorporated into Mac OS X. \\ open source & A software ideology, where the source code to software (what is compiled into the program you run) is freely available. Also known as Free Software, exactly what makes a program open source is a good way to get into an argument. \\ @@ -89,7 +93,7 @@ A web page that syndicates blogs. UCC has one at \url{http://planet.ucc.asn.au/} Secret Wheel Song & The song that is supposedly sung at the beginning of each Wheel meeting. \\ % Elitism alert... (It's tradition!) SLA & -A Service Level Agreement. A document describing how reliable services are. UCC does not have one, and you should not ask Wheel members about it. \\ +A Service Level Agreement. A document describing how reliable services are. UCC does not have one. \\ terminal server & Sort of a router for serial ports, allows you to connect to one serial port from another. Usually connected to DEC Terminals, servers and dispense. (It can also refer to other sorts of servers which provide login sessions over the network). \\ theft book & @@ -103,7 +107,7 @@ someone who spends a lot of time in the UCC. Some UCCans pass their units. \\ Unifi & The University wireless network. Available around campus where UCC's wireless is not. You need to be a student to access it though. \\ UniSFA & -the University Science Fiction Association, the ones down the hall. \\ +the University Science Fiction Association, the ones down the hall. ``UCC and UniSFA, a twisted pair'' \\ VM & A VM or Virtual Machine is a computer emulated on top of another computer. Many of the UCC's servers run inside VMs. The claim is that UCC's VMs are not a ``single point of failure.'' That's the machine they are all running on: \server{medico}. \\ WAIX & diff --git a/chapters/Groups.tex b/chapters/Groups.tex index 69ee7d49b6232a0aa281e28f90d0644a6a69da03..65ee363e6ade016e0e096b0d6f962e35c9a53263 100644 --- a/chapters/Groups.tex +++ b/chapters/Groups.tex @@ -1,20 +1,9 @@ \zchapter{UCC::Groups} % Explanation of the groups. -\newenvironment{uccgroup}[1] -{ - \begin{mdframed}[nobreak=true] - \section{\textsc{#1}} - \begin{mdframed} - Contact: <\href{mailto:#1@ucc.asn.au}{#1@ucc.asn.au}> - \end{mdframed} - \begin{mdframed} - Members: \small{\url{http://www.ucc.asn.au/infobase/groups/#1.ucc}} - \end{mdframed} - - - -}{\end{mdframed}} +\newenvironment{uccgroup}[1] { + \section{\textsc{\href{mailto:#1@ucc.asn.au}{#1@ucc.asn.au}}} +} % Is this section a little elitist sounding, or is that just the entire group system? [SZM] \begin{mdframed} @@ -44,18 +33,16 @@ The Fresher Rep is your voice on the Committee. Get to know them and let them kn %\begin{mdframed} Fresher Rep: <\href{mailto:fresher@ucc.asn.au}{fresher@ucc.asn.au}> %\end{mdframed} -\end{uccgroup} -\pagebreak -\begin{uccgroup}{wheel} - -Wheel is in charge of maintaining the club's machines. They are the best people to see if you're having problems with the computers. Wheel maintains its own membership, but works hand in hand with Committee on issues relating to account policy. If you abuse your account, it will be locked by a Wheel member. The unlocking of accounts is at the discretion of Committee. Wheel have infrequent meetings, where they sing the secret wheel song. % THIS DOESN'T ACTUALLY HAPPEN - \end{uccgroup} \begin{uccgroup}{door} The Door group is responsible for the clubroom itself. Only a member of door group can unlock the clubroom and keep it open for members during the day. This means that if the only Door group member in the room has to leave, then everyone will have to leave until another Door group member arrives. \end{uccgroup} -\pagebreak + +\begin{uccgroup}{wheel} +Wheel is in charge of maintaining the club's machines. They are the best people to see if you're having problems with the computers. Wheel maintains its own membership, but works hand in hand with Committee on issues relating to account policy. If you abuse your account, it will be locked by a Wheel member. The unlocking of accounts is at the discretion of Committee. Wheel have infrequent meetings, where they sing the secret wheel song. % THIS DOESN'T ACTUALLY HAPPEN +\end{uccgroup} + \begin{uccgroup}{coke} The Coke group are the people to talk to if you want to add money to your dispense account (see the section on dispense). They can also credit your account for bad dispenses and other tasks related to dispense. \end{uccgroup} diff --git a/chapters/Services.tex b/chapters/Services.tex index 8020c425d6de0dd91559b99c52e5e90bc11c553a..04c34744c19d6c2c081b69530b75ce067ef8d609 100644 --- a/chapters/Services.tex +++ b/chapters/Services.tex @@ -1,6 +1,7 @@ \zchapter{UCC::Services} -\newcommand{\server}[1]{\emph{#1}} +% clash with global command +% \newcommand{\server}[1]{\emph{#1}} \begin{mdframed} \null @@ -11,19 +12,17 @@ This Chapter provides an overview of UCC's services (as of January 2014); how to Remember that all services are maintained by UCC's members. If you are interested in learning more, or running a new service, ask someone! - \end{mdframed} \newenvironment{uccservice}[2] { - \begin{mdframed} \section{#1} \begin{mdframed} Machine(s) Involved: \server{#2} \end{mdframed} -}{\end{mdframed}} +} \begin{uccservice}{Games}{heathred} @@ -39,8 +38,6 @@ Administrator access to \server{heathred} is fairly unrestricted; it is also ava \end{uccservice} -\pagebreak - \begin{uccservice}{Drinks and Snacks --- Dispense}{merlo, coke machine, snack machine} UCC's most successful service is undoubtably the internet connected coke machine and not quite internet connected snack machine. These use serial communications to talk to \server{merlo}, which runs open source software written by talented members including John Hodge, Mark Tearle and David Adam. @@ -60,13 +57,10 @@ Mumble is a thing for voice chat whilst playing games. \server{heathred} runs a \end{uccservice} \begin{uccservice}{Clubroom Music}{robotnik} - From within the clubroom, you can navigate to \url{http://robotnik} to play music over the speakers. Beware, as repeated abuse may lead to activation of the dreaded "loldongs" mode. - \end{uccservice} -\pagebreak -\begin{uccservice}{Email}{mooneye} +\begin{uccservice}{Email}{mooneye} UCC proudly runs its own mail server. You have an email account <username@ucc.asn.au>. The address <username@ucc.gu.uwa.edu.au> will also work. Upon creating your account you can choose an address to foward all emails to. You can change this at any time by editing the ".forward" file in your home directory. @@ -81,37 +75,24 @@ Alternately, you can use one of several methods to check your UCC email directly \end{uccservice} \begin{uccservice}{Web Hosting}{mantis, mussel} - Members can publish their own sites! SSH to a server and edit the files in the directory "public-html". The website will appear at \url{http://username.ucc.asn.au}. - \end{uccservice} -\pagebreak - \begin{uccservice}{Wiki Hosting}{mooneye} - UCC uses a Wiki called "MoinMoin" to store documentation on servers, events, and miscellaneous things. It is visible at \url{http://wiki.ucc.asn.au}. - \end{uccservice} \begin{uccservice}{User Logins}{mussel, mylah} - We use something called LDAP for authentication and linux accounts. SAMBA is involved for windows logins. Only one member really knows how this works, so I will move swiftly on. - \end{uccservice} \begin{uccservice}{Network Servers}{murasoi, mooneye} - Murasoi is a wheel-only server which serves as a router for all of UCC's networks and runs the infamous "ucc-fw" firewall. Murasoi also acts as the DHCP server. DNS is on mooneye. The magic that makes \url{http://username.ucc.asn.au} point to your website happens on mooneye. - \end{uccservice} -\pagebreak - \begin{uccservice}{File Storage}{mylah, enron/stearns, nortel/onetel, motsugo} - With your account comes not one, but \emph{two} "home" directories for your files. The one most commonly seen is accessable on clubroom machines. It will be named "/home/ucc/username" on clubroom linux machines. On servers however, that path leads to a different home directory; to get to your clubroom home directory (called "away") you must access "/away/ucc/username". @@ -126,35 +107,24 @@ If you are using Linux, you can use the program "sshfs" to mount your home or aw %\server{motsugo}'s disks contain "home" which is exported only to servers via NFS. %The NetApp \server{nortel} and \server{onetel} store Virtual Machine (VM) images, and "/services" --- the directory that contains UCC's website, amongst other things. - - \end{uccservice} \begin{uccservice}{Virtual Machine Hosting}{medico, motsugo, heathred, mylah} - Members who are particularly nice to wheel group can get their own VM hosted at UCC. \server{medico} runs the amazing ProxMox interface and is used for all new VMs. The typical way to use this interface is from a web browser on \server{maaxen}, a VM running on \server{medico}... \server{heathred} is used for VMs when wheel complains that they aren't important enough to justify using all of \server{medico}'s CPU *cough* minecraft *cough*. - \end{uccservice} \begin{uccservice}{Windows Server}{maaxen} - \server{maaxen} is our token Windows server. It can be accessed through RDP, but beware, as it only supports two simultaneous sessions. \server{maaxen} boasts a range of useful programs including Notepad and Matlab. - \end{uccservice} \begin{uccservice}{IRC}{mussel, mantis} - IRC is discussed in Chapters \ref{SetupAccount} and \ref{Communications}. Our two IRC servers are bridged with CASSA and ComSSA, computer science associations at other Universities. - \end{uccservice} \begin{uccservice}{General Use}{motsugo} - SSH access is available to several servers, but \server{motsugo} is the best choice for general use. It is mostly used for personal software projects, and to run members' screen sessions so they can be \emph{constantly} connected to IRC. - \end{uccservice} - diff --git a/chapters/UnixCommands.tex b/chapters/UnixCommands.tex index 506f7316dea353ce5e073c8215b88cb9ff981f14..9ad4f504e000d784e8090c9c09ac1df15762258d 100644 --- a/chapters/UnixCommands.tex +++ b/chapters/UnixCommands.tex @@ -1,5 +1,8 @@ \zchapter{Common UNIX/Linux Commands}\label{UnixCommands} +% Whenever a chapter is started with a figure or table, it forces a blank page? +% -> Add some text +In the Beginning was the Command Line. %\begin{mdframed} @@ -18,30 +21,31 @@ - \uc{logout}{Logs you off the system. Do this before you leave.} - \uc{ls <directory>}{Lists the files in the given directory (folder).} - \uc{cd <directory>}{Change to the given directory (folder).} - \uc{mkdir <directory>}{Add the specified directory (folder).} - \uc{rmdir <directory>}{Remove the specified directory (folder).} - \uc{pwd}{"Print Working Directory" --- Displays the path of the directory you are currently in.} - \uc{less <file>}{Read through a file (\emph{space} scrolls on a page, \emph{q} will quit)} - \uc{cp <source> <destination>}{Make a copy of a file in a new place.} - \uc{mv <source> <destination>}{Move (rename) a file.} + \uc{logout}{Logs you off the system. Do this before you leave} + \uc{ls <directory>}{Lists the files in the given directory (folder)} + \uc{cd <directory>}{Change to the given directory (folder)} + \uc{mkdir <directory>}{Add the specified directory (folder)} + \uc{rmdir <directory>}{Remove the specified directory (folder)} + \uc{pwd}{"Print Working Directory" --- Displays the path of the directory you are currently in} + \uc{less <file>}{Read through a file (\emph{space} scrolls, \emph{q} quits)} + \uc{cp <source> <destination>}{Make a copy of a file in a new place} + \uc{mv <source> <destination>}{Move (rename) a file} \uc{rm <file>}{\textsc{{Permanently deletes a file. \newline There is no "Recycle Bin"!}}} - \uc{alpine}{This program can be used for reading emails.} - \uc{nano <file>, vim <file>, emacs <file>}{Three different text file editors. \shell{nano} is the simplest.} - \uc{finger <username>, tla <username or TLA>, who}{Check to see who someone is and if they are logged in.} - \uc{ssh <username>@<hostname>}{Log in (securely) to another (UNIX) machine.} - \uc{ping <hostname>}{Ping another machine to see if it is up and what the latency is. Press \emph{Ctrl-C} to cancel.} - \uc{man <command>}{Displays the manual for a command. See \shell{man man} for more information.} - \uc{top}{Displays an updating list of current processes on the system.} - \uc{ps}{Lists the processes you are running on this terminal (names and PIDs)} +% \uc{alpine}{This program can be used for reading emails} + \uc{nano <file>, vim <file>, emacs <file>}{Three different text file editors. \shell{nano} is the simplest} + \uc{finger <username>}{Check to see who someone is and if they are logged in} + \uc{tla <username|TLA>}{Look up a UCC TLA} + \uc{ssh <username>@<hostname>}{Log in (securely) to another (UNIX) machine} + \uc{ping <hostname>}{Ping another machine to see if it is up and what the latency is. Press \emph{Ctrl-C} to cancel} + \uc{man <command>}{Displays the manual for a command. See \shell{man man} for more information} + \uc{top}{Displays an updating list of current processes} +% \uc{ps}{Lists the processes you are running on this terminal (names and PIDs)} \uc{ps aux}{Lists all processes running on the system} - \uc{kill <PID>}{Tell a process it should stop. \shell{kill -9} will kill a process immediately.} + \uc{kill <PID>}{Tell a process it should stop. \shell{kill -9} will kill a process immediately} \uc{passwd}{On \server{mussel} - Change your login password} \uc{dispense}{Get yourself a delicious drink!} - \uc{gcc/g++}{C/C++ compilers for compiling some awesome code you wrote.} - \uc{python}{Python interpreter for interpreting some OK code you wrote.} + \uc{gcc/g++}{C/C++ compilers for compiling some awesome code you wrote} + \uc{python}{Python interpreter for interpreting some OK code you wrote} \uc{irssi}{Join IRC to chat/argue with other members} \hline \end{tabular} diff --git a/fresher_guide.pdf b/fresher_guide.pdf index 2b624e76a4b19586fc3ff13aee048eb62e36f3fe..b88328a852ff8e265edf24902ebab3e43830b40a 100644 Binary files a/fresher_guide.pdf and b/fresher_guide.pdf differ diff --git a/fresher_guide.tex b/fresher_guide.tex index 912300d0943e49a21ebd220a98d65202497a87f4..6c46ebc64d4f18759b7ee7cb325ef2a0f05fa68c 100644 --- a/fresher_guide.tex +++ b/fresher_guide.tex @@ -35,6 +35,11 @@ \usepackage{float} \usepackage[compact]{titlesec} \titlespacing{\chapter}{0pt}{-50pt}{0pt} +% spacing glue: how to read {12pt plus 4pt minus 2pt} +% 12pt is what we would like the spacing to be +% plus 4pt means that TeX can stretch it by at most 4pt +% minus 2pt means that TeX can shrink it by at most 2pt +\titlespacing\section{0pt}{0pt plus 0pt minus 2pt}{0pt plus 0pt minus 2pt} \titleformat{\chapter} {\normalfont\LARGE\bfseries}{\thechapter.}{1em}{}