Updated help targets for modules

configure/modules/RULES_CELL

 .PHONY: fix_permissions cellinstall celluninstall
 
-ifneq (,$(findstring cell,$(MAKECMDGOALS)))
-
+## Installs the module in a local directory $(E3_CELL_PATH)
 cellinstall: install_module versions fix_permissions
 
 celluninstall: conf
 	$(QUIET) $(SUDOBASH) '$(E3_MODULE_MAKE_CMDS) uninstall'
-	$(SUDO) rm -rf $(E3_MODULES_PATH)
+	#$(SUDO) rm -rf $(E3_MODULES_PATH)
+
+cellvars: vars
+
+ifneq (,$(findstring cell,$(MAKECMDGOALS)))
 
 versions:
 	@echo EPICS_BASE: $(EPICS_BASE)                  > $(E3_CELL_PATH)/$(E3_MODULE_NAME)/$(E3_MODULE_VERSION)/EPICS_VERSION

configure/modules/RULES_E3

@@ -28,44 +28,43 @@ help:
 
 
 
-## Install : $(E3_MODULE_NAME)
+## Install current module to $(EPICS_BASE)/require/$(E3_REQUIRE_VERSION)/siteMods
 install: install_module install_links vlibs
 
 #install_module: uninstall 
 install_module: build db
 	$(QUIET) $(SUDOBASH) '$(E3_MODULE_MAKE_CMDS) install'
 
-## Uninstall : $(E3_MODULE_NAME)
+## Uninstall the current module
 uninstall: conf
 	$(QUIET) $(SUDOBASH) '$(E3_MODULE_MAKE_CMDS) uninstall'
 
-## Build the EPICS Module : $(E3_MODULE_NAME)
-# Build always the Module with the EPICS_MODULES_TAG
+## Build current module. 
 build: conf checkout prebuild
 	$(QUIET) $(E3_MODULE_MAKE_CMDS) build
 
-# Allows a module developer to run some commands before `build`
+## Run module-specific commands before building
 prebuild: conf
 	$(QUIET) $(E3_MODULE_MAKE_CMDS) prebuild
 
-# Runs the debug command from driver.Makefile which outputs a lot of information about the build process
+## Displays information about the build process
 debug: conf
 	$(QUIET) $(E3_MODULE_MAKE_CMDS) debug
 
-## Clean, build, and install the EPICS Module : $(E3_MODULE_NAME)
+## Clean, build, and install the current module
 rebuild: clean build install
 
-## Clean : $(E3_MODULE_NAME)
+## Deletes temporary build files
 clean: conf
 	$(QUIET) $(E3_MODULE_MAKE_CMDS) clean
 
 all: init patch rebuild
 
-## Copy $(E3_MODULE_MAKEFILE) into $(E3_MODULE_SRC_PATH)
+# Copy $(E3_MODULE_MAKEFILE) into $(E3_MODULE_SRC_PATH)
 conf: module_name_check
 	$(QUIET) install -p -m 644 $(TOP)/$(E3_MODULE_MAKEFILE)  $(E3_MODULE_SRC_PATH)/
 
-## We should check that the module name satisfies a few conditions before we go on.
+# We should check that the module name satisfies a few conditions before we go on.
 module_name_check:
 ifneq ($(shell echo $(E3_MODULE_NAME) | grep '^[a-z_][a-z0-9_]\+$$' > /dev/null 2>&1; echo $$?),0)
 	$(error E3_MODULE_NAME '$(E3_MODULE_NAME)' is not valid. It should consist only of lowercase letters, numbers, and underscores.)
@@ -89,7 +88,7 @@ init:
 checkout:
 
 else
-## Initialize : $(E3_MODULE_SRC_PATH) 
+## Syncs and checks out tag $(EPICS_MODULE_TAG) for the submodule 
 init: git-submodule-sync $(E3_MODULE_SRC_PATH)  checkout
 
 

configure/modules/RULES_VARS

@@ -45,7 +45,7 @@ header:
 	$(QUIET)echo "------------------------------------------------------------"
 	$(QUIET)echo ""
 
-
+## Show installed versions of the current module
 existent:
 ifeq (, $(shell which tree))
 	$(QUIET)ls -d $(E3_MODULES_PATH)/$(E3_MODULE_NAME)
@@ -54,8 +54,6 @@ else
 	$(QUIET)tree -L $(LEVEL) $(E3_MODULES_PATH)/$(E3_MODULE_NAME)
 endif
 
-cellvars: vars
-
 dep: _dep2
 ifneq ("$(wildcard $(GENERATED_DEP_FILE))","")
 	$(QUIET)echo "> generated ..."

configure/modules/RULES_VLIBS

 
 .PHONY: vlibs
 
+## Install vendor libraries
 vlibs: conf
 	$(QUIET) $(E3_MODULE_MAKE_CMDS) vlibs