docs: update comment formatting

Author: mikesmitty

src/machine/machine_rp2_usb.go

@@ -21,8 +21,8 @@ func initEndpoint(ep, config uint32) {
 	offset := ep*2*usbBufferLen + 0x100
 	val |= offset
 
-	// Bulk and interrupt endpoints must have their Packet ID reset to DATA0 when un-stalled
-	epXPIDReset[ep] = false // Default to false in case an endpoint is re-initialized
+	// Bulk and interrupt endpoints must have their Packet ID reset to DATA0 when un-stalled.
+	epXPIDReset[ep] = false // Default to false in case an endpoint is re-initialized.
 
 	switch config {
 	case usb.ENDPOINT_TYPE_INTERRUPT | usb.EndpointIn:
@@ -119,7 +119,7 @@ func handleEndpointRxComplete(ep uint32) {
 	setEPDataPID(ep, !epXdata0[ep])
 }
 
-// Set the USB endpoint Packet ID to DATA0 or DATA1
+// Set the USB endpoint Packet ID to DATA0 or DATA1.
 func setEPDataPID(ep uint32, dataOne bool) {
 	epXdata0[ep] = dataOne
 	if epXdata0[ep] || ep == 0 {
@@ -150,7 +150,7 @@ func sendViaEPIn(ep uint32, data []byte, count int) {
 	_usbDPSRAM.EPxBufferControl[ep&0x7F].In.Set(val)
 }
 
-// Set ENDPOINT_HALT/stall status on a USB IN endpoint
+// Set ENDPOINT_HALT/stall status on a USB IN endpoint.
 func (dev *USBDevice) SetStallEPIn(ep uint32) {
 	// Prepare buffer control register value
 	if ep == 0 {
@@ -162,7 +162,7 @@ func (dev *USBDevice) SetStallEPIn(ep uint32) {
 	_usbDPSRAM.EPxBufferControl[ep&0x7F].In.Set(val)
 }
 
-// Set ENDPOINT_HALT/stall status on a USB OUT endpoint
+// Set ENDPOINT_HALT/stall status on a USB OUT endpoint.
 func (dev *USBDevice) SetStallEPOut(ep uint32) {
 	if ep == 0 {
 		panic("SetStallEPOut: EP0 OUT not valid")
@@ -171,7 +171,7 @@ func (dev *USBDevice) SetStallEPOut(ep uint32) {
 	_usbDPSRAM.EPxBufferControl[ep&0x7F].Out.Set(val)
 }
 
-// Clear the ENDPOINT_HALT/stall on a USB IN endpoint
+// Clear the ENDPOINT_HALT/stall on a USB IN endpoint.
 func (dev *USBDevice) ClearStallEPIn(ep uint32) {
 	ep = ep & 0x7F
 	val := uint32(usbBuf0CtrlStall)
@@ -182,7 +182,7 @@ func (dev *USBDevice) ClearStallEPIn(ep uint32) {
 	}
 }
 
-// Clear the ENDPOINT_HALT/stall on a USB OUT endpoint
+// Clear the ENDPOINT_HALT/stall on a USB OUT endpoint.
 func (dev *USBDevice) ClearStallEPOut(ep uint32) {
 	ep = ep & 0x7F
 	val := uint32(usbBuf0CtrlStall)