doc: add and improve comments

cmd/server/main.go

@@ -14,35 +14,42 @@ import (
 )
 
 var (
-	// Define CLI flags
+	// define CLI flags
 	listenAddress   = flag.String("listenAddress", shared.DefaultServerConfig.ListenAddress, "IP address to listen on")
 	listenPort      = flag.Int("listenPort", shared.DefaultServerConfig.ListenPort, "Port to listen on")
 	password        = flag.String("password", "", "Control password for pomodoro session (optional)")
 	showVersionFlag = flag.Bool("version", false, "Output version")
 )
 
+// Start the pomodoro server
 func Start() {
 	flag.Parse()
 
+	// show server and protocl version and exit
 	if *showVersionFlag {
-		fmt.Println("App-Version:", metadata.GoTomatoVersion)
+		fmt.Println("Server-Version:", metadata.GoTomatoVersion)
 		fmt.Println("Protocol-Version:", metadata.ProtocolVersion)
 		os.Exit(0)
 	}
 
+	// set server config
 	serverConfig := models.ServerConfig{
 		ListenAddress: *listenAddress,
 		ListenPort:    *listenPort,
 	}
 	shared.PomodoroPassword = *password
 
+	// define listen address for websocket
 	listen := fmt.Sprintf("%s:%d", serverConfig.ListenAddress, serverConfig.ListenPort)
 
+	// start connection handler and broadcast
 	http.HandleFunc("/ws", websocket.HandleConnection)
 	go websocket.SendPermanentBroadCastMessage()
 
 	log.Info("GoTomato started", "version", metadata.GoTomatoVersion)
 	log.Info("Websocket listening", "address", listen)
+
+	// start the listener
 	err := http.ListenAndServe(listen, nil)
 	if err != nil {
 		log.Fatal("Error starting server:", "msg", err)