diff --git a/Marlin/Conditionals.h b/Marlin/Conditionals.h
index bea1cc7725b0fcbac2f13ad9afd320389dcf5a13..376946ab7ce19a183c9a4a5b60b6769a87eca2ea 100644
--- a/Marlin/Conditionals.h
+++ b/Marlin/Conditionals.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,7 +20,7 @@
*
*/
-/*
+/**
* Conditionals.h
* Defines that depend on configuration but are not editable.
*/
diff --git a/Marlin/Configuration.h b/Marlin/Configuration.h
index f8470b92e9c32586451af92e07c3b25d46f4c85a..0ded362096dab4b4f0812a359bb585e3344765c3 100644
--- a/Marlin/Configuration.h
+++ b/Marlin/Configuration.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,6 +20,21 @@
*
*/
+/**
+ * Configuration.h
+ *
+ * Basic settings such as:
+ *
+ * - Type of electronics
+ * - Type of temperature sensor
+ * - Printer geometry
+ * - Endstop configuration
+ * - LCD controller
+ * - Extra features
+ *
+ * Advanced settings can be found in Configuration_adv.h
+ *
+ */
#ifndef CONFIGURATION_H
#define CONFIGURATION_H
@@ -29,8 +44,10 @@
//===========================================================================
//============================= Getting Started =============================
//===========================================================================
-/*
-Here are some standard links for getting your machine calibrated:
+
+/**
+ * Here are some standard links for getting your machine calibrated:
+ *
* http://reprap.org/wiki/Calibration
* http://youtu.be/wAL9d7FgInk
* http://calculator.josefprusa.cz
@@ -38,11 +55,7 @@ Here are some standard links for getting your machine calibrated:
* http://www.thingiverse.com/thing:5573
* https://sites.google.com/site/repraplogphase/calibration-of-your-reprap
* http://www.thingiverse.com/thing:298812
-*/
-
-// This configuration file contains the basic settings.
-// Advanced settings can be found in Configuration_adv.h
-// BASIC SETTINGS: select your board type, temperature sensor type, axis scaling, and endstop configuration
+ */
//===========================================================================
//============================= DELTA Printer ===============================
diff --git a/Marlin/Configuration_adv.h b/Marlin/Configuration_adv.h
index cc190263322342bf7ade8b962f6a220960f67b5e..d137169d1a77c54d12802bb23465cac302b3a2d2 100644
--- a/Marlin/Configuration_adv.h
+++ b/Marlin/Configuration_adv.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,6 +20,16 @@
*
*/
+/**
+ * Configuration_adv.h
+ *
+ * Advanced settings.
+ * Only change these if you know exactly what you're doing.
+ * Some of these settings can damage your printer if improperly set!
+ *
+ * Basic settings can be found in Configuration.h
+ *
+ */
#ifndef CONFIGURATION_ADV_H
#define CONFIGURATION_ADV_H
diff --git a/Marlin/Default_Version.h b/Marlin/Default_Version.h
index 39b1fcbd2e4b2f7bf81708bb7afb31445a53d7f5..f8259b40c852d322a44fba7231fa44586ecbfddd 100644
--- a/Marlin/Default_Version.h
+++ b/Marlin/Default_Version.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,7 +20,7 @@
*
*/
-/*
+/**
* This file is a placeholder for a file which could be distributed in an archive
* It takes the place of an automatically created "_Version.h" which is generated during the build process
*/
diff --git a/Marlin/M100_Free_Mem_Chk.cpp b/Marlin/M100_Free_Mem_Chk.cpp
index bc096f144d6429d178e0380291158fde7697dd9f..f7900a0f35486f033ee4c130327ab29d21e9d0b4 100644
--- a/Marlin/M100_Free_Mem_Chk.cpp
+++ b/Marlin/M100_Free_Mem_Chk.cpp
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,29 +20,26 @@
*
*/
+/**
+ * M100 Free Memory Watcher
+ *
+ * This code watches the free memory block between the bottom of the heap and the top of the stack.
+ * This memory block is initialized and watched via the M100 command.
+ *
+ * M100 I Initializes the free memory block and prints vitals statistics about the area
+ * M100 F Identifies how much of the free memory block remains free and unused. It also
+ * detects and reports any corruption within the free memory block that may have
+ * happened due to errant firmware.
+ * M100 D Does a hex display of the free memory block along with a flag for any errant
+ * data that does not match the expected value.
+ * M100 C x Corrupts x locations within the free memory block. This is useful to check the
+ * correctness of the M100 F and M100 D commands.
+ *
+ * Initial version by Roxy-3DPrintBoard
+ */
#define M100_FREE_MEMORY_DUMPER // Comment out to remove Dump sub-command
#define M100_FREE_MEMORY_CORRUPTOR // Comment out to remove Corrupt sub-command
-
-// M100 Free Memory Watcher
-//
-// This code watches the free memory block between the bottom of the heap and the top of the stack.
-// This memory block is initialized and watched via the M100 command.
-//
-// M100 I Initializes the free memory block and prints vitals statistics about the area
-// M100 F Identifies how much of the free memory block remains free and unused. It also
-// detects and reports any corruption within the free memory block that may have
-// happened due to errant firmware.
-// M100 D Does a hex display of the free memory block along with a flag for any errant
-// data that does not match the expected value.
-// M100 C x Corrupts x locations within the free memory block. This is useful to check the
-// correctness of the M100 F and M100 D commands.
-//
-// Initial version by Roxy-3DPrintBoard
-//
-//
-
-
#include "Marlin.h"
#if ENABLED(M100_FREE_MEMORY_WATCHER)
diff --git a/Marlin/Marlin.h b/Marlin/Marlin.h
index 4cdea594985b7f514757de6a49cdfead70a27919..8819b3fb8fe90e67259b8506e41bd6da9df667e0 100644
--- a/Marlin/Marlin.h
+++ b/Marlin/Marlin.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/Marlin.ino b/Marlin/Marlin.ino
index 5648e47fa9750036f2320018c22cf985a70c4936..7c4dd93014bfe8e36301320fd5507c223578fe15 100644
--- a/Marlin/Marlin.ino
+++ b/Marlin/Marlin.ino
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,7 +20,7 @@
*
*/
-/*
+/**
* About Marlin
*
* This firmware is a mashup between Sprinter and grbl.
diff --git a/Marlin/MarlinSerial.cpp b/Marlin/MarlinSerial.cpp
index 2800cb04fdd791628d460a983c65537fdc79b2e2..e6362fc7c78c0785fb195ddce045f303d177b815 100644
--- a/Marlin/MarlinSerial.cpp
+++ b/Marlin/MarlinSerial.cpp
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,7 +20,7 @@
*
*/
-/*
+/**
HardwareSerial.cpp - Hardware serial library for Wiring
Copyright (c) 2006 Nicholas Zambetti. All right reserved.
diff --git a/Marlin/MarlinSerial.h b/Marlin/MarlinSerial.h
index b884f242aea2e57ee5b1c4340af7ac599c235eca..6af14557e40895d0f79c59a1168a31760ac79550 100644
--- a/Marlin/MarlinSerial.h
+++ b/Marlin/MarlinSerial.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,7 +20,7 @@
*
*/
-/*
+/**
HardwareSerial.h - Hardware serial library for Wiring
Copyright (c) 2006 Nicholas Zambetti. All right reserved.
diff --git a/Marlin/Marlin_main.cpp b/Marlin/Marlin_main.cpp
index f9707daf1143b5afd116bd712b1673db16b7cca5..edc36914c3f598d390b002d6e11b0ba3a32b2d85 100644
--- a/Marlin/Marlin_main.cpp
+++ b/Marlin/Marlin_main.cpp
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,7 +20,7 @@
*
*/
-/*
+/**
*
* About Marlin
*
@@ -6618,7 +6618,7 @@ void clamp_to_software_endstops(float target[3]) {
- sq(delta_tower3_x - cartesian[X_AXIS])
- sq(delta_tower3_y - cartesian[Y_AXIS])
) + cartesian[Z_AXIS];
- /*
+ /**
SERIAL_ECHOPGM("cartesian x="); SERIAL_ECHO(cartesian[X_AXIS]);
SERIAL_ECHOPGM(" y="); SERIAL_ECHO(cartesian[Y_AXIS]);
SERIAL_ECHOPGM(" z="); SERIAL_ECHOLN(cartesian[Z_AXIS]);
@@ -6653,7 +6653,7 @@ void clamp_to_software_endstops(float target[3]) {
delta[Y_AXIS] += offset;
delta[Z_AXIS] += offset;
- /*
+ /**
SERIAL_ECHOPGM("grid_x="); SERIAL_ECHO(grid_x);
SERIAL_ECHOPGM(" grid_y="); SERIAL_ECHO(grid_y);
SERIAL_ECHOPGM(" floor_x="); SERIAL_ECHO(floor_x);
@@ -7145,7 +7145,7 @@ void plan_arc(
delta[Y_AXIS] = (SCARA_theta + SCARA_psi) * SCARA_RAD2DEG; // - equal to sub arm angle (inverted motor)
delta[Z_AXIS] = cartesian[Z_AXIS];
- /*
+ /**
SERIAL_ECHOPGM("cartesian x="); SERIAL_ECHO(cartesian[X_AXIS]);
SERIAL_ECHOPGM(" y="); SERIAL_ECHO(cartesian[Y_AXIS]);
SERIAL_ECHOPGM(" z="); SERIAL_ECHOLN(cartesian[Z_AXIS]);
diff --git a/Marlin/SanityCheck.h b/Marlin/SanityCheck.h
index 5204fce5962ddb0de4e6950355b1be8e8e90a0b6..16df8fbbfb04412289a27ac8e1deccfa712677d1 100644
--- a/Marlin/SanityCheck.h
+++ b/Marlin/SanityCheck.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/Sd2Card.cpp b/Marlin/Sd2Card.cpp
index a97315c71831a23a8a9b1e6dc79116710c57a585..53935feb109bf9daa8348f88ea34498d9e98c7a7 100644
--- a/Marlin/Sd2Card.cpp
+++ b/Marlin/Sd2Card.cpp
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,7 +20,7 @@
*
*/
-/*
+/**
* Arduino Sd2Card Library
* Copyright (C) 2009 by William Greiman
*
diff --git a/Marlin/Sd2Card.h b/Marlin/Sd2Card.h
index 5cc4c540ca3622144a9cff64af74aa96219e4286..106890fefa1a6ed584d92a2d5b6853d7bc8cc8fe 100644
--- a/Marlin/Sd2Card.h
+++ b/Marlin/Sd2Card.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,7 +20,7 @@
*
*/
-/*
+/**
* Arduino Sd2Card Library
* Copyright (C) 2009 by William Greiman
*
diff --git a/Marlin/Sd2PinMap.h b/Marlin/Sd2PinMap.h
index 0287bb187d5582ba2c3e14356752670719ac7211..698e1c224df4878f8f2dfd7b897ebf6e71d6fed0 100644
--- a/Marlin/Sd2PinMap.h
+++ b/Marlin/Sd2PinMap.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,7 +20,7 @@
*
*/
-/*
+/**
* Arduino SdFat Library
* Copyright (C) 2010 by William Greiman
*
diff --git a/Marlin/SdBaseFile.cpp b/Marlin/SdBaseFile.cpp
index 0e5db7bea2b16f4c8d0a9fff219f0593af7ce007..472a60a56a016cacff67db722b7de1f8c3ca569e 100644
--- a/Marlin/SdBaseFile.cpp
+++ b/Marlin/SdBaseFile.cpp
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,7 +20,7 @@
*
*/
-/*
+/**
* Arduino SdFat Library
* Copyright (C) 2009 by William Greiman
*
diff --git a/Marlin/SdBaseFile.h b/Marlin/SdBaseFile.h
index ef98535f71b65c63fe8f1f884b00bc1ab65fc1db..2b912d2ed1cd820e551cf94970a0b9d5747b840c 100644
--- a/Marlin/SdBaseFile.h
+++ b/Marlin/SdBaseFile.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,7 +20,7 @@
*
*/
-/*
+/**
* Arduino SdFat Library
* Copyright (C) 2009 by William Greiman
*
diff --git a/Marlin/SdFatConfig.h b/Marlin/SdFatConfig.h
index d496ffd4f742c190f2aa94249f2a7e601b52733c..f9cb9fe1400935daf6112378b1824cd673d7a52c 100644
--- a/Marlin/SdFatConfig.h
+++ b/Marlin/SdFatConfig.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,7 +20,7 @@
*
*/
-/*
+/**
* Arduino SdFat Library
* Copyright (C) 2009 by William Greiman
*
diff --git a/Marlin/SdFatStructs.h b/Marlin/SdFatStructs.h
index c7a761c4f83d2c2ae03cfe45fd7571161cd64a92..3e989dea9d02304136915adf60db52a202b7e66a 100644
--- a/Marlin/SdFatStructs.h
+++ b/Marlin/SdFatStructs.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,7 +20,7 @@
*
*/
-/*
+/**
* Arduino SdFat Library
* Copyright (C) 2009 by William Greiman
*
@@ -37,7 +37,7 @@
* \file
* \brief FAT file structures
*/
-/*
+/**
* mostly from Microsoft document fatgen103.doc
* http://www.microsoft.com/whdc/system/platform/firmware/fatgen.mspx
*/
diff --git a/Marlin/SdFatUtil.cpp b/Marlin/SdFatUtil.cpp
index ba31299eaebead46173222bb98af27f26402a1ef..48d91df682839f3b5d1505ceecb75fbb2243e7da 100644
--- a/Marlin/SdFatUtil.cpp
+++ b/Marlin/SdFatUtil.cpp
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,7 +20,7 @@
*
*/
-/*
+/**
* Arduino SdFat Library
* Copyright (C) 2008 by William Greiman
*
diff --git a/Marlin/SdFatUtil.h b/Marlin/SdFatUtil.h
index af4f45f8d6cbd2ced45362280e2953906e590363..93c633ca8b444141ec4263de5d3c89a532dd6674 100644
--- a/Marlin/SdFatUtil.h
+++ b/Marlin/SdFatUtil.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,7 +20,7 @@
*
*/
-/*
+/**
* Arduino SdFat Library
* Copyright (C) 2008 by William Greiman
*
diff --git a/Marlin/SdFile.cpp b/Marlin/SdFile.cpp
index 81f63a4f4a90d1dc97e5546b16b62b60b9629abd..d5748efe246da9616886eb32cf713f437eb515e2 100644
--- a/Marlin/SdFile.cpp
+++ b/Marlin/SdFile.cpp
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,7 +20,7 @@
*
*/
-/*
+/**
* Arduino SdFat Library
* Copyright (C) 2009 by William Greiman
*
diff --git a/Marlin/SdFile.h b/Marlin/SdFile.h
index c15b210b416e2a3d2264d853584b42f250ec87dd..53f38255cb969135be58b8a659ebdb41b26b318e 100644
--- a/Marlin/SdFile.h
+++ b/Marlin/SdFile.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,7 +20,7 @@
*
*/
-/*
+/**
* Arduino SdFat Library
* Copyright (C) 2009 by William Greiman
*
diff --git a/Marlin/SdInfo.h b/Marlin/SdInfo.h
index 74cf65f268b5693e5e31f7c1a042b14c07f52eef..f07dd6c0175abadbbf4e15efa4e8a799f8101b70 100644
--- a/Marlin/SdInfo.h
+++ b/Marlin/SdInfo.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,7 +20,7 @@
*
*/
-/*
+/**
* Arduino Sd2Card Library
* Copyright (C) 2009 by William Greiman
*
diff --git a/Marlin/SdVolume.cpp b/Marlin/SdVolume.cpp
index c488f75197f2e906e852e82d5cf7ceeb6e79b3e1..e9c69dfc90372f4ae82203e4ad5568690baec9fd 100644
--- a/Marlin/SdVolume.cpp
+++ b/Marlin/SdVolume.cpp
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,7 +20,7 @@
*
*/
-/*
+/**
* Arduino SdFat Library
* Copyright (C) 2009 by William Greiman
*
diff --git a/Marlin/SdVolume.h b/Marlin/SdVolume.h
index 296d9955b9a04c1085a1f1a30c11fa1fd17091dd..990248d6a6a1effd5ddd900363d12094ea01159e 100644
--- a/Marlin/SdVolume.h
+++ b/Marlin/SdVolume.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,7 +20,7 @@
*
*/
-/*
+/**
* Arduino SdFat Library
* Copyright (C) 2009 by William Greiman
*
diff --git a/Marlin/blinkm.cpp b/Marlin/blinkm.cpp
index c8d1c747ac530f99704e2d941360ac6ea9cebe3f..c495a5debd987a2e64205580a39f2a05e0f19e3b 100644
--- a/Marlin/blinkm.cpp
+++ b/Marlin/blinkm.cpp
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,7 +20,7 @@
*
*/
-/*
+/**
* blinkm.cpp - Library for controlling a BlinkM over i2c
* Created by Tim Koster, August 21 2013.
*/
diff --git a/Marlin/blinkm.h b/Marlin/blinkm.h
index 0ecc4417029178f260fe63f039d4f8e571658ced..ed2ad79bb239666317edfc81fd3cac7934483b6b 100644
--- a/Marlin/blinkm.h
+++ b/Marlin/blinkm.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,7 +20,7 @@
*
*/
-/*
+/**
* blinkm.h - Library for controlling a BlinkM over i2c
* Created by Tim Koster, August 21 2013.
*/
diff --git a/Marlin/boards.h b/Marlin/boards.h
index 4395984ea75539b79a98041093e3f5abd90e55e9..6b297fcad2308fe44053856525850dbe1eb95ae9 100644
--- a/Marlin/boards.h
+++ b/Marlin/boards.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/buzzer.cpp b/Marlin/buzzer.cpp
index a53858cda56a16002ee5dd12437c7a52f22075d6..776ea4dfaedc9a3ff92a66399bb495aa394420b2 100644
--- a/Marlin/buzzer.cpp
+++ b/Marlin/buzzer.cpp
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/buzzer.h b/Marlin/buzzer.h
index 307b18c9dfc6cbfc0b19fd8ad8175efd0acc7766..ec568ecd87da6fba11c9f2216ce951e87affe520 100644
--- a/Marlin/buzzer.h
+++ b/Marlin/buzzer.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/cardreader.cpp b/Marlin/cardreader.cpp
index 9eea93f538c1549abc4f4b9a28dc19bf217f4a26..bb2d6e1dd8c8428994a0d0df1ad9a86653fd647a 100644
--- a/Marlin/cardreader.cpp
+++ b/Marlin/cardreader.cpp
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -245,7 +245,7 @@ void CardReader::initsd() {
}
workDir = root;
curDir = &root;
- /*
+ /**
if (!workDir.openRoot(&volume)) {
SERIAL_ECHOLNPGM(MSG_SD_WORKDIR_FAIL);
}
diff --git a/Marlin/cardreader.h b/Marlin/cardreader.h
index cc8064ec5875f56332d31fc403430965da46d724..8bd53e551f2d909e7b222082f197ab7ad5eaf4e2 100644
--- a/Marlin/cardreader.h
+++ b/Marlin/cardreader.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/configuration_store.cpp b/Marlin/configuration_store.cpp
index 240cac91dbb7c41c64154ce210564b2af5d68c53..d9929e10a1dd80ff8b6f4c45edf57a62ffe312ad 100644
--- a/Marlin/configuration_store.cpp
+++ b/Marlin/configuration_store.cpp
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,7 +20,7 @@
*
*/
-/*
+/**
* configuration_store.cpp
*
* Configuration and EEPROM storage
diff --git a/Marlin/configuration_store.h b/Marlin/configuration_store.h
index 1c68a323f93fa22889c9adf071d0d5f59711752e..2b2680607ab776ac702a1bf9929a0c52b780a05f 100644
--- a/Marlin/configuration_store.h
+++ b/Marlin/configuration_store.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/dac_mcp4728.cpp b/Marlin/dac_mcp4728.cpp
index e58772c2b1cdce2e2b07277aa1c00ebcc36a39e7..3060e6e1840969596432cf6d80cee4206ac3ea3a 100644
--- a/Marlin/dac_mcp4728.cpp
+++ b/Marlin/dac_mcp4728.cpp
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,7 +20,7 @@
*
*/
-/*
+/**
* mcp4728.cpp - Arduino library for MicroChip MCP4728 I2C D/A converter
*
* For implementation details, please take a look at the datasheet:
@@ -30,18 +30,15 @@
* http://arduino.cc/forum/index.php/topic,51842.0.html
*/
-
-/* _____PROJECT INCLUDES_____________________________________________________ */
#include "dac_mcp4728.h"
#if ENABLED(DAC_STEPPER_CURRENT)
-// Used Global variables
uint16_t mcp4728_values[4];
-/*
-Begin I2C, get current values (input register and eeprom) of mcp4728
-*/
+/**
+ * Begin I2C, get current values (input register and eeprom) of mcp4728
+ */
void mcp4728_init() {
Wire.begin();
Wire.requestFrom(int(DAC_DEV_ADDRESS), 24);
@@ -58,19 +55,19 @@ void mcp4728_init() {
}
}
-/*
-Write input resister value to specified channel using fastwrite method.
-Channel : 0-3, Values : 0-4095
-*/
+/**
+ * Write input resister value to specified channel using fastwrite method.
+ * Channel : 0-3, Values : 0-4095
+ */
uint8_t mcp4728_analogWrite(uint8_t channel, uint16_t value) {
mcp4728_values[channel] = value;
return mcp4728_fastWrite();
}
-/*
-Write all input resistor values to EEPROM using SequencialWrite method.
-This will update both input register and EEPROM value
-This will also write current Vref, PowerDown, Gain settings to EEPROM
-*/
+/**
+ * Write all input resistor values to EEPROM using SequencialWrite method.
+ * This will update both input register and EEPROM value
+ * This will also write current Vref, PowerDown, Gain settings to EEPROM
+ */
uint8_t mcp4728_eepromWrite() {
Wire.beginTransmission(DAC_DEV_ADDRESS);
Wire.send(SEQWRITE);
@@ -81,31 +78,32 @@ uint8_t mcp4728_eepromWrite() {
return Wire.endTransmission();
}
-/*
- Write Voltage reference setting to all input regiters
-*/
+/**
+ * Write Voltage reference setting to all input regiters
+ */
uint8_t mcp4728_setVref_all(uint8_t value) {
Wire.beginTransmission(DAC_DEV_ADDRESS);
Wire.send(VREFWRITE | value << 3 | value << 2 | value << 1 | value);
return Wire.endTransmission();
}
-/*
- Write Gain setting to all input regiters
-*/
+/**
+ * Write Gain setting to all input regiters
+ */
uint8_t mcp4728_setGain_all(uint8_t value) {
Wire.beginTransmission(DAC_DEV_ADDRESS);
Wire.send(GAINWRITE | value << 3 | value << 2 | value << 1 | value);
return Wire.endTransmission();
}
-/*
- Return Input Regiter value
-*/
+/**
+ * Return Input Regiter value
+ */
uint16_t mcp4728_getValue(uint8_t channel) { return mcp4728_values[channel]; }
-/*
-// Steph: Might be useful in the future
-// Return Vout
+/**
+ * Steph: Might be useful in the future
+ * Return Vout
+ *
uint16_t mcp4728_getVout(uint8_t channel) {
uint32_t vref = 2048;
uint32_t vOut = (vref * mcp4728_values[channel] * (_DAC_STEPPER_GAIN + 1)) / 4096;
@@ -114,11 +112,11 @@ uint16_t mcp4728_getVout(uint8_t channel) {
}
*/
-/*
-FastWrite input register values - All DAC ouput update. refer to DATASHEET 5.6.1
-DAC Input and PowerDown bits update.
-No EEPROM update
-*/
+/**
+ * FastWrite input register values - All DAC ouput update. refer to DATASHEET 5.6.1
+ * DAC Input and PowerDown bits update.
+ * No EEPROM update
+ */
uint8_t mcp4728_fastWrite() {
Wire.beginTransmission(DAC_DEV_ADDRESS);
for (uint8_t channel=0; channel <= 3; channel++) {
@@ -128,9 +126,9 @@ uint8_t mcp4728_fastWrite() {
return Wire.endTransmission();
}
-/*
-Common function for simple general commands
-*/
+/**
+ * Common function for simple general commands
+ */
uint8_t mcp4728_simpleCommand(byte simpleCommand) {
Wire.beginTransmission(GENERALCALL);
Wire.send(simpleCommand);
diff --git a/Marlin/dac_mcp4728.h b/Marlin/dac_mcp4728.h
index 9dbe3299a0af2e5639f2d33dae1bee5ba9631444..e1739c563049b98c93720699d864d3cbdf113d37 100644
--- a/Marlin/dac_mcp4728.h
+++ b/Marlin/dac_mcp4728.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,7 +20,7 @@
*
*/
-/*
+/**
* Arduino library for MicroChip MCP4728 I2C D/A converter.
*/
diff --git a/Marlin/digipot_mcp4451.cpp b/Marlin/digipot_mcp4451.cpp
index b32a4c3acd9ddfea76052c23efa9960dbaec88c2..771581341aec65449457cca2051d92a2842c2c33 100644
--- a/Marlin/digipot_mcp4451.cpp
+++ b/Marlin/digipot_mcp4451.cpp
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/dogm_bitmaps.h b/Marlin/dogm_bitmaps.h
index bf8e8e35c8bbb2dedf2ab4d1336d348dd64d248e..db55a46a3406597a63f11b6dc526923cdf004988 100644
--- a/Marlin/dogm_bitmaps.h
+++ b/Marlin/dogm_bitmaps.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,7 +20,7 @@
*
*/
-/*
+/**
* BitMap for splashscreen
* Generated with: http://www.digole.com/tools/PicturetoC_Hex_converter.php
* Please note that using the high-res version takes 402Bytes of PROGMEM.
diff --git a/Marlin/dogm_font_data_6x9_marlin.h b/Marlin/dogm_font_data_6x9_marlin.h
index 91a7d06a2980f1e837412da593a4d17dad2eb557..f298a6ac7882e78e66b07cad67a79032786d3f58 100644
--- a/Marlin/dogm_font_data_6x9_marlin.h
+++ b/Marlin/dogm_font_data_6x9_marlin.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,7 +20,7 @@
*
*/
-/*
+/**
Fontname: -Misc-Fixed-Medium-R-Normal--9-90-75-75-C-60-ISO10646-1
Copyright: Public domain font. Share and enjoy.
Capital A Height: 6, '1' Height: 6
diff --git a/Marlin/dogm_font_data_HD44780_C.h b/Marlin/dogm_font_data_HD44780_C.h
index e2c8f7848c6a305d210ab3a8f5d16b34b4f5e9ef..21d4aaabe28d49dedfd076554f2624d13d4cd554 100644
--- a/Marlin/dogm_font_data_HD44780_C.h
+++ b/Marlin/dogm_font_data_HD44780_C.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,7 +20,7 @@
*
*/
-/*
+/**
Fontname: HD44780_C v1.2
Copyright: A. Hardtung, public domain
Capital A Height: 7, '1' Height: 7
diff --git a/Marlin/dogm_font_data_HD44780_J.h b/Marlin/dogm_font_data_HD44780_J.h
index a4f22f76096d129f31ca58ee1dac9d55f2ab45b4..8b1b19847d45d186627faad051921b994ef314e4 100644
--- a/Marlin/dogm_font_data_HD44780_J.h
+++ b/Marlin/dogm_font_data_HD44780_J.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,7 +20,7 @@
*
*/
-/*
+/**
Fontname: HD44780_J
Copyright: A. Hardtung, public domain
Capital A Height: 7, '1' Height: 7
diff --git a/Marlin/dogm_font_data_HD44780_W.h b/Marlin/dogm_font_data_HD44780_W.h
index 35852959a7712624af3ff7d9efe6e244c2e666b3..86b4bf4bffe073210d9bab3fd30389c46dfe5cb5 100644
--- a/Marlin/dogm_font_data_HD44780_W.h
+++ b/Marlin/dogm_font_data_HD44780_W.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,7 +20,7 @@
*
*/
-/*
+/**
Fontname: HD44780_W
Copyright: A.Hardtung, public domain
Capital A Height: 7, '1' Height: 7
diff --git a/Marlin/dogm_font_data_ISO10646_1.h b/Marlin/dogm_font_data_ISO10646_1.h
index 0a47dd5e7210e2da18d5b85d597ef65eabf7c511..8ff40d054f52ea30f37ba310c3d8eaf6c4aaf4b1 100644
--- a/Marlin/dogm_font_data_ISO10646_1.h
+++ b/Marlin/dogm_font_data_ISO10646_1.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,7 +20,7 @@
*
*/
-/*
+/**
Fontname: ISO10646-1
Copyright: A.Hardtung, public domain
Capital A Height: 7, '1' Height: 7
diff --git a/Marlin/dogm_font_data_ISO10646_5_Cyrillic.h b/Marlin/dogm_font_data_ISO10646_5_Cyrillic.h
index b54c5cb37b775a735a81372cf445b35bda702274..75e779fd0f644713ffd72c2e8cda2f4d5eadfd3b 100644
--- a/Marlin/dogm_font_data_ISO10646_5_Cyrillic.h
+++ b/Marlin/dogm_font_data_ISO10646_5_Cyrillic.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,7 +20,7 @@
*
*/
-/*
+/**
Fontname: ISO10646_5_Cyrillic
Copyright: A. Hardtung, public domain
Capital A Height: 7, '1' Height: 7
diff --git a/Marlin/dogm_font_data_ISO10646_CN.h b/Marlin/dogm_font_data_ISO10646_CN.h
index 7c10372b3388d95e56223f50a5f0161c62ec606d..11fdb2240b01fd34d2400c4538b340af38718b07 100644
--- a/Marlin/dogm_font_data_ISO10646_CN.h
+++ b/Marlin/dogm_font_data_ISO10646_CN.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,7 +20,7 @@
*
*/
-/*
+/**
Fontname: ISO10646_CN
Copyright: A. Hardtung, public domain
Capital A Height: 7, '1' Height: 7
diff --git a/Marlin/dogm_font_data_ISO10646_Kana.h b/Marlin/dogm_font_data_ISO10646_Kana.h
index 39feaf40a0fc1368464c47987e58c4054b841a9f..372412cf0a89fbc9fa63995d2bd859c2c61796c6 100644
--- a/Marlin/dogm_font_data_ISO10646_Kana.h
+++ b/Marlin/dogm_font_data_ISO10646_Kana.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,7 +20,7 @@
*
*/
-/*
+/**
Fontname: ISO10646_Kana
Copyright: A. Hardtung, public domain
Capital A Height: 7, '1' Height: 7
diff --git a/Marlin/dogm_font_data_Marlin_symbols.h b/Marlin/dogm_font_data_Marlin_symbols.h
index 976d3d240299e3d95318fac7e2af9ecec92ec38f..ad9b983b20d6b0d41a42a6d28314177d4c1d7bd5 100644
--- a/Marlin/dogm_font_data_Marlin_symbols.h
+++ b/Marlin/dogm_font_data_Marlin_symbols.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,7 +20,7 @@
*
*/
-/*
+/**
Fontname: Marlin_symbols
Copyright: Created with Fony 1.4.7
Capital A Height: 0, '1' Height: 0
diff --git a/Marlin/dogm_lcd_implementation.h b/Marlin/dogm_lcd_implementation.h
index 1637d20d7482b7ebfeaf1252b858e91c1de3457d..107b8608f2be99ee1480060cd0ddc7e7c148cf20 100644
--- a/Marlin/dogm_lcd_implementation.h
+++ b/Marlin/dogm_lcd_implementation.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/example_configurations/Felix/Configuration.h b/Marlin/example_configurations/Felix/Configuration.h
index 597014d69b48ac24cac2c559289df44f80c219b1..e7c7a30b6c3519579c26c0e394c2fcd4d466fc4b 100644
--- a/Marlin/example_configurations/Felix/Configuration.h
+++ b/Marlin/example_configurations/Felix/Configuration.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,6 +20,21 @@
*
*/
+/**
+ * Configuration.h
+ *
+ * Basic settings such as:
+ *
+ * - Type of electronics
+ * - Type of temperature sensor
+ * - Printer geometry
+ * - Endstop configuration
+ * - LCD controller
+ * - Extra features
+ *
+ * Advanced settings can be found in Configuration_adv.h
+ *
+ */
#ifndef CONFIGURATION_H
#define CONFIGURATION_H
@@ -29,8 +44,10 @@
//===========================================================================
//============================= Getting Started =============================
//===========================================================================
-/*
-Here are some standard links for getting your machine calibrated:
+
+/**
+ * Here are some standard links for getting your machine calibrated:
+ *
* http://reprap.org/wiki/Calibration
* http://youtu.be/wAL9d7FgInk
* http://calculator.josefprusa.cz
@@ -38,11 +55,7 @@ Here are some standard links for getting your machine calibrated:
* http://www.thingiverse.com/thing:5573
* https://sites.google.com/site/repraplogphase/calibration-of-your-reprap
* http://www.thingiverse.com/thing:298812
-*/
-
-// This configuration file contains the basic settings.
-// Advanced settings can be found in Configuration_adv.h
-// BASIC SETTINGS: select your board type, temperature sensor type, axis scaling, and endstop configuration
+ */
//===========================================================================
//============================= DELTA Printer ===============================
diff --git a/Marlin/example_configurations/Felix/Configuration_DUAL.h b/Marlin/example_configurations/Felix/Configuration_DUAL.h
index e219face85b2b0274a18037735e6b1d21ce23248..9ef89040c02a44208160da1faf39daaa37d5dab4 100644
--- a/Marlin/example_configurations/Felix/Configuration_DUAL.h
+++ b/Marlin/example_configurations/Felix/Configuration_DUAL.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,6 +20,21 @@
*
*/
+/**
+ * Configuration.h
+ *
+ * Basic settings such as:
+ *
+ * - Type of electronics
+ * - Type of temperature sensor
+ * - Printer geometry
+ * - Endstop configuration
+ * - LCD controller
+ * - Extra features
+ *
+ * Advanced settings can be found in Configuration_adv.h
+ *
+ */
#ifndef CONFIGURATION_H
#define CONFIGURATION_H
@@ -29,8 +44,10 @@
//===========================================================================
//============================= Getting Started =============================
//===========================================================================
-/*
-Here are some standard links for getting your machine calibrated:
+
+/**
+ * Here are some standard links for getting your machine calibrated:
+ *
* http://reprap.org/wiki/Calibration
* http://youtu.be/wAL9d7FgInk
* http://calculator.josefprusa.cz
@@ -38,11 +55,7 @@ Here are some standard links for getting your machine calibrated:
* http://www.thingiverse.com/thing:5573
* https://sites.google.com/site/repraplogphase/calibration-of-your-reprap
* http://www.thingiverse.com/thing:298812
-*/
-
-// This configuration file contains the basic settings.
-// Advanced settings can be found in Configuration_adv.h
-// BASIC SETTINGS: select your board type, temperature sensor type, axis scaling, and endstop configuration
+ */
//===========================================================================
//============================= DELTA Printer ===============================
diff --git a/Marlin/example_configurations/Felix/Configuration_adv.h b/Marlin/example_configurations/Felix/Configuration_adv.h
index 9e95fe5c24ffb15483a44a964330604a9e20953f..216d164158598d64538f77439e6b8940b8246ddd 100644
--- a/Marlin/example_configurations/Felix/Configuration_adv.h
+++ b/Marlin/example_configurations/Felix/Configuration_adv.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,6 +20,16 @@
*
*/
+/**
+ * Configuration_adv.h
+ *
+ * Advanced settings.
+ * Only change these if you know exactly what you're doing.
+ * Some of these settings can damage your printer if improperly set!
+ *
+ * Basic settings can be found in Configuration.h
+ *
+ */
#ifndef CONFIGURATION_ADV_H
#define CONFIGURATION_ADV_H
diff --git a/Marlin/example_configurations/Hephestos/Configuration.h b/Marlin/example_configurations/Hephestos/Configuration.h
index 65918ea89eab9dd0921a410170fe938328a282f9..3f90aa4ec8f99b4dcb9c1f3f3d37af5d64025b2f 100644
--- a/Marlin/example_configurations/Hephestos/Configuration.h
+++ b/Marlin/example_configurations/Hephestos/Configuration.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,6 +20,21 @@
*
*/
+/**
+ * Configuration.h
+ *
+ * Basic settings such as:
+ *
+ * - Type of electronics
+ * - Type of temperature sensor
+ * - Printer geometry
+ * - Endstop configuration
+ * - LCD controller
+ * - Extra features
+ *
+ * Advanced settings can be found in Configuration_adv.h
+ *
+ */
#ifndef CONFIGURATION_H
#define CONFIGURATION_H
@@ -29,8 +44,10 @@
//===========================================================================
//============================= Getting Started =============================
//===========================================================================
-/*
-Here are some standard links for getting your machine calibrated:
+
+/**
+ * Here are some standard links for getting your machine calibrated:
+ *
* http://reprap.org/wiki/Calibration
* http://youtu.be/wAL9d7FgInk
* http://calculator.josefprusa.cz
@@ -38,11 +55,7 @@ Here are some standard links for getting your machine calibrated:
* http://www.thingiverse.com/thing:5573
* https://sites.google.com/site/repraplogphase/calibration-of-your-reprap
* http://www.thingiverse.com/thing:298812
-*/
-
-// This configuration file contains the basic settings.
-// Advanced settings can be found in Configuration_adv.h
-// BASIC SETTINGS: select your board type, temperature sensor type, axis scaling, and endstop configuration
+ */
//===========================================================================
//============================= DELTA Printer ===============================
diff --git a/Marlin/example_configurations/Hephestos/Configuration_adv.h b/Marlin/example_configurations/Hephestos/Configuration_adv.h
index f828f184eb484e14c392ef12fe2fccea8836da06..2bd84d0b4689679a8b45fc96a992161ed8a373f8 100644
--- a/Marlin/example_configurations/Hephestos/Configuration_adv.h
+++ b/Marlin/example_configurations/Hephestos/Configuration_adv.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,6 +20,16 @@
*
*/
+/**
+ * Configuration_adv.h
+ *
+ * Advanced settings.
+ * Only change these if you know exactly what you're doing.
+ * Some of these settings can damage your printer if improperly set!
+ *
+ * Basic settings can be found in Configuration.h
+ *
+ */
#ifndef CONFIGURATION_ADV_H
#define CONFIGURATION_ADV_H
diff --git a/Marlin/example_configurations/Hephestos_2/Configuration.h b/Marlin/example_configurations/Hephestos_2/Configuration.h
index 94c6c3138d8ca44789bd3377180f686dd10a1dec..5b56789d40d35bf23527153cc66218fab3f0acd4 100644
--- a/Marlin/example_configurations/Hephestos_2/Configuration.h
+++ b/Marlin/example_configurations/Hephestos_2/Configuration.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,6 +20,21 @@
*
*/
+/**
+ * Configuration.h
+ *
+ * Basic settings such as:
+ *
+ * - Type of electronics
+ * - Type of temperature sensor
+ * - Printer geometry
+ * - Endstop configuration
+ * - LCD controller
+ * - Extra features
+ *
+ * Advanced settings can be found in Configuration_adv.h
+ *
+ */
#ifndef CONFIGURATION_H
#define CONFIGURATION_H
@@ -29,8 +44,10 @@
//===========================================================================
//============================= Getting Started =============================
//===========================================================================
-/*
-Here are some standard links for getting your machine calibrated:
+
+/**
+ * Here are some standard links for getting your machine calibrated:
+ *
* http://reprap.org/wiki/Calibration
* http://youtu.be/wAL9d7FgInk
* http://calculator.josefprusa.cz
@@ -38,11 +55,7 @@ Here are some standard links for getting your machine calibrated:
* http://www.thingiverse.com/thing:5573
* https://sites.google.com/site/repraplogphase/calibration-of-your-reprap
* http://www.thingiverse.com/thing:298812
-*/
-
-// This configuration file contains the basic settings.
-// Advanced settings can be found in Configuration_adv.h
-// BASIC SETTINGS: select your board type, temperature sensor type, axis scaling, and endstop configuration
+ */
//===========================================================================
//============================= DELTA Printer ===============================
diff --git a/Marlin/example_configurations/Hephestos_2/Configuration_adv.h b/Marlin/example_configurations/Hephestos_2/Configuration_adv.h
index fc85677241a68f73756778d358b7204943c1413a..c3ac27d7d6717d90fa016de07fd7bd51b0fc6a47 100644
--- a/Marlin/example_configurations/Hephestos_2/Configuration_adv.h
+++ b/Marlin/example_configurations/Hephestos_2/Configuration_adv.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,6 +20,16 @@
*
*/
+/**
+ * Configuration_adv.h
+ *
+ * Advanced settings.
+ * Only change these if you know exactly what you're doing.
+ * Some of these settings can damage your printer if improperly set!
+ *
+ * Basic settings can be found in Configuration.h
+ *
+ */
#ifndef CONFIGURATION_ADV_H
#define CONFIGURATION_ADV_H
diff --git a/Marlin/example_configurations/K8200/Configuration.h b/Marlin/example_configurations/K8200/Configuration.h
index 06c7ca0855abb4d53f7d61a36a7e56dd3cc13e94..1c6090c0014f8c706b9c3b082aa081bed3fc0753 100644
--- a/Marlin/example_configurations/K8200/Configuration.h
+++ b/Marlin/example_configurations/K8200/Configuration.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,11 +20,28 @@
*
*/
-// Sample configuration file for Vellemann K8200
-// tested on K8200 with VM8201 (Display)
-// and Arduino 1.6.8 (Mac) by @CONSULitAS, 2016-02-21
-// https://github.com/CONSULitAS/Marlin-K8200/archive/K8200_stable_2016-02-21.zip
+/**
+ * Sample configuration file for Vellemann K8200
+ * tested on K8200 with VM8201 (Display)
+ * and Arduino 1.6.8 (Mac) by @CONSULitAS, 2016-02-21
+ * https://github.com/CONSULitAS/Marlin-K8200/archive/K8200_stable_2016-02-21.zip
+ */
+/**
+ * Configuration.h
+ *
+ * Basic settings such as:
+ *
+ * - Type of electronics
+ * - Type of temperature sensor
+ * - Printer geometry
+ * - Endstop configuration
+ * - LCD controller
+ * - Extra features
+ *
+ * Advanced settings can be found in Configuration_adv.h
+ *
+ */
#ifndef CONFIGURATION_H
#define CONFIGURATION_H
@@ -34,8 +51,10 @@
//===========================================================================
//============================= Getting Started =============================
//===========================================================================
-/*
-Here are some standard links for getting your machine calibrated:
+
+/**
+ * Here are some standard links for getting your machine calibrated:
+ *
* http://reprap.org/wiki/Calibration
* http://youtu.be/wAL9d7FgInk
* http://calculator.josefprusa.cz
@@ -43,11 +62,7 @@ Here are some standard links for getting your machine calibrated:
* http://www.thingiverse.com/thing:5573
* https://sites.google.com/site/repraplogphase/calibration-of-your-reprap
* http://www.thingiverse.com/thing:298812
-*/
-
-// This configuration file contains the basic settings.
-// Advanced settings can be found in Configuration_adv.h
-// BASIC SETTINGS: select your board type, temperature sensor type, axis scaling, and endstop configuration
+ */
//===========================================================================
//============================= DELTA Printer ===============================
diff --git a/Marlin/example_configurations/K8200/Configuration_adv.h b/Marlin/example_configurations/K8200/Configuration_adv.h
index c90c93ff027229ae77a67f8f2c2d2ef4fe44741a..3a58710a5a8085ef2ba6db90eaa86f0a167ac7ef 100644
--- a/Marlin/example_configurations/K8200/Configuration_adv.h
+++ b/Marlin/example_configurations/K8200/Configuration_adv.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -25,6 +25,17 @@
// and Arduino 1.6.8 (Mac) by @CONSULitAS, 2016-02-21
// https://github.com/CONSULitAS/Marlin-K8200/archive/K8200_stable_2016-02-21.zip
+
+/**
+ * Configuration_adv.h
+ *
+ * Advanced settings.
+ * Only change these if you know exactly what you're doing.
+ * Some of these settings can damage your printer if improperly set!
+ *
+ * Basic settings can be found in Configuration.h
+ *
+ */
#ifndef CONFIGURATION_ADV_H
#define CONFIGURATION_ADV_H
diff --git a/Marlin/example_configurations/RepRapWorld/Megatronics/Configuration.h b/Marlin/example_configurations/RepRapWorld/Megatronics/Configuration.h
index 0ed470257547409f911cbf606ed8876064b9c1f3..b2fb63a2b4451b1116e189d5f7fae01a34ca00d8 100644
--- a/Marlin/example_configurations/RepRapWorld/Megatronics/Configuration.h
+++ b/Marlin/example_configurations/RepRapWorld/Megatronics/Configuration.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,6 +20,21 @@
*
*/
+/**
+ * Configuration.h
+ *
+ * Basic settings such as:
+ *
+ * - Type of electronics
+ * - Type of temperature sensor
+ * - Printer geometry
+ * - Endstop configuration
+ * - LCD controller
+ * - Extra features
+ *
+ * Advanced settings can be found in Configuration_adv.h
+ *
+ */
#ifndef CONFIGURATION_H
#define CONFIGURATION_H
@@ -29,8 +44,10 @@
//===========================================================================
//============================= Getting Started =============================
//===========================================================================
-/*
-Here are some standard links for getting your machine calibrated:
+
+/**
+ * Here are some standard links for getting your machine calibrated:
+ *
* http://reprap.org/wiki/Calibration
* http://youtu.be/wAL9d7FgInk
* http://calculator.josefprusa.cz
@@ -38,11 +55,7 @@ Here are some standard links for getting your machine calibrated:
* http://www.thingiverse.com/thing:5573
* https://sites.google.com/site/repraplogphase/calibration-of-your-reprap
* http://www.thingiverse.com/thing:298812
-*/
-
-// This configuration file contains the basic settings.
-// Advanced settings can be found in Configuration_adv.h
-// BASIC SETTINGS: select your board type, temperature sensor type, axis scaling, and endstop configuration
+ */
//===========================================================================
//============================= DELTA Printer ===============================
diff --git a/Marlin/example_configurations/RigidBot/Configuration.h b/Marlin/example_configurations/RigidBot/Configuration.h
index caea2418efd7394452130c4cbf6cae729a0755c1..82417593329b8661a719e1e12f9e496d4be2228e 100644
--- a/Marlin/example_configurations/RigidBot/Configuration.h
+++ b/Marlin/example_configurations/RigidBot/Configuration.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,6 +20,21 @@
*
*/
+/**
+ * Configuration.h
+ *
+ * Basic settings such as:
+ *
+ * - Type of electronics
+ * - Type of temperature sensor
+ * - Printer geometry
+ * - Endstop configuration
+ * - LCD controller
+ * - Extra features
+ *
+ * Advanced settings can be found in Configuration_adv.h
+ *
+ */
#ifndef CONFIGURATION_H
#define CONFIGURATION_H
@@ -29,8 +44,10 @@
//===========================================================================
//============================= Getting Started =============================
//===========================================================================
-/*
-Here are some standard links for getting your machine calibrated:
+
+/**
+ * Here are some standard links for getting your machine calibrated:
+ *
* http://reprap.org/wiki/Calibration
* http://youtu.be/wAL9d7FgInk
* http://calculator.josefprusa.cz
@@ -38,11 +55,7 @@ Here are some standard links for getting your machine calibrated:
* http://www.thingiverse.com/thing:5573
* https://sites.google.com/site/repraplogphase/calibration-of-your-reprap
* http://www.thingiverse.com/thing:298812
-*/
-
-// This configuration file contains the basic settings.
-// Advanced settings can be found in Configuration_adv.h
-// BASIC SETTINGS: select your board type, temperature sensor type, axis scaling, and endstop configuration
+ */
//===========================================================================
//============================= DELTA Printer ===============================
diff --git a/Marlin/example_configurations/RigidBot/Configuration_adv.h b/Marlin/example_configurations/RigidBot/Configuration_adv.h
index 316881e75b800241cff17d978311c4949ecb70f9..23233e5107f0b6052b6abcee63c27035c0a4d7a9 100644
--- a/Marlin/example_configurations/RigidBot/Configuration_adv.h
+++ b/Marlin/example_configurations/RigidBot/Configuration_adv.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,6 +20,16 @@
*
*/
+/**
+ * Configuration_adv.h
+ *
+ * Advanced settings.
+ * Only change these if you know exactly what you're doing.
+ * Some of these settings can damage your printer if improperly set!
+ *
+ * Basic settings can be found in Configuration.h
+ *
+ */
#ifndef CONFIGURATION_ADV_H
#define CONFIGURATION_ADV_H
diff --git a/Marlin/example_configurations/SCARA/Configuration.h b/Marlin/example_configurations/SCARA/Configuration.h
index 6eb99c15fb304236a07b6647de201a3f8f435119..2e8bd5c7b78b35fa7933aafa1f3956b6cb6916da 100644
--- a/Marlin/example_configurations/SCARA/Configuration.h
+++ b/Marlin/example_configurations/SCARA/Configuration.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,6 +20,21 @@
*
*/
+/**
+ * Configuration.h
+ *
+ * Basic settings such as:
+ *
+ * - Type of electronics
+ * - Type of temperature sensor
+ * - Printer geometry
+ * - Endstop configuration
+ * - LCD controller
+ * - Extra features
+ *
+ * Advanced settings can be found in Configuration_adv.h
+ *
+ */
#ifndef CONFIGURATION_H
#define CONFIGURATION_H
@@ -29,8 +44,10 @@
//===========================================================================
//============================= Getting Started =============================
//===========================================================================
-/*
-Here are some standard links for getting your machine calibrated:
+
+/**
+ * Here are some standard links for getting your machine calibrated:
+ *
* http://reprap.org/wiki/Calibration
* http://youtu.be/wAL9d7FgInk
* http://calculator.josefprusa.cz
@@ -38,11 +55,7 @@ Here are some standard links for getting your machine calibrated:
* http://www.thingiverse.com/thing:5573
* https://sites.google.com/site/repraplogphase/calibration-of-your-reprap
* http://www.thingiverse.com/thing:298812
-*/
-
-// This configuration file contains the basic settings.
-// Advanced settings can be found in Configuration_adv.h
-// BASIC SETTINGS: select your board type, temperature sensor type, axis scaling, and endstop configuration
+ */
//===========================================================================
//============================= DELTA Printer ===============================
diff --git a/Marlin/example_configurations/SCARA/Configuration_adv.h b/Marlin/example_configurations/SCARA/Configuration_adv.h
index ecf4b6503b04da39a2c4e3d68a5b5bb82ce5116e..a8ee979d2eb18976c596710fe3217d5addbe65f2 100644
--- a/Marlin/example_configurations/SCARA/Configuration_adv.h
+++ b/Marlin/example_configurations/SCARA/Configuration_adv.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,6 +20,16 @@
*
*/
+/**
+ * Configuration_adv.h
+ *
+ * Advanced settings.
+ * Only change these if you know exactly what you're doing.
+ * Some of these settings can damage your printer if improperly set!
+ *
+ * Basic settings can be found in Configuration.h
+ *
+ */
#ifndef CONFIGURATION_ADV_H
#define CONFIGURATION_ADV_H
diff --git a/Marlin/example_configurations/TAZ4/Configuration.h b/Marlin/example_configurations/TAZ4/Configuration.h
index 0515ebca61a105e878989a8a73cab7dc748d8e0b..fc4c0c75747b9c9cf23af045b3d05555dfbe8f50 100644
--- a/Marlin/example_configurations/TAZ4/Configuration.h
+++ b/Marlin/example_configurations/TAZ4/Configuration.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,6 +20,21 @@
*
*/
+/**
+ * Configuration.h
+ *
+ * Basic settings such as:
+ *
+ * - Type of electronics
+ * - Type of temperature sensor
+ * - Printer geometry
+ * - Endstop configuration
+ * - LCD controller
+ * - Extra features
+ *
+ * Advanced settings can be found in Configuration_adv.h
+ *
+ */
#ifndef CONFIGURATION_H
#define CONFIGURATION_H
@@ -29,8 +44,10 @@
//===========================================================================
//============================= Getting Started =============================
//===========================================================================
-/*
-Here are some standard links for getting your machine calibrated:
+
+/**
+ * Here are some standard links for getting your machine calibrated:
+ *
* http://reprap.org/wiki/Calibration
* http://youtu.be/wAL9d7FgInk
* http://calculator.josefprusa.cz
@@ -38,11 +55,7 @@ Here are some standard links for getting your machine calibrated:
* http://www.thingiverse.com/thing:5573
* https://sites.google.com/site/repraplogphase/calibration-of-your-reprap
* http://www.thingiverse.com/thing:298812
-*/
-
-// This configuration file contains the basic settings.
-// Advanced settings can be found in Configuration_adv.h
-// BASIC SETTINGS: select your board type, temperature sensor type, axis scaling, and endstop configuration
+ */
//===========================================================================
//============================= DELTA Printer ===============================
diff --git a/Marlin/example_configurations/TAZ4/Configuration_adv.h b/Marlin/example_configurations/TAZ4/Configuration_adv.h
index 6a64d03adaa09081406676a6b2059a55f16c35f9..70d7db61017d99d22537195eb53178151d31dab9 100644
--- a/Marlin/example_configurations/TAZ4/Configuration_adv.h
+++ b/Marlin/example_configurations/TAZ4/Configuration_adv.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,6 +20,16 @@
*
*/
+/**
+ * Configuration_adv.h
+ *
+ * Advanced settings.
+ * Only change these if you know exactly what you're doing.
+ * Some of these settings can damage your printer if improperly set!
+ *
+ * Basic settings can be found in Configuration.h
+ *
+ */
#ifndef CONFIGURATION_ADV_H
#define CONFIGURATION_ADV_H
diff --git a/Marlin/example_configurations/WITBOX/Configuration.h b/Marlin/example_configurations/WITBOX/Configuration.h
index 5db9f21429aab5660dc7873d969f467900509dd4..5a0a5ec3a4d9d9c42ad35fe7f42145e431990932 100644
--- a/Marlin/example_configurations/WITBOX/Configuration.h
+++ b/Marlin/example_configurations/WITBOX/Configuration.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,6 +20,21 @@
*
*/
+/**
+ * Configuration.h
+ *
+ * Basic settings such as:
+ *
+ * - Type of electronics
+ * - Type of temperature sensor
+ * - Printer geometry
+ * - Endstop configuration
+ * - LCD controller
+ * - Extra features
+ *
+ * Advanced settings can be found in Configuration_adv.h
+ *
+ */
#ifndef CONFIGURATION_H
#define CONFIGURATION_H
@@ -29,8 +44,10 @@
//===========================================================================
//============================= Getting Started =============================
//===========================================================================
-/*
-Here are some standard links for getting your machine calibrated:
+
+/**
+ * Here are some standard links for getting your machine calibrated:
+ *
* http://reprap.org/wiki/Calibration
* http://youtu.be/wAL9d7FgInk
* http://calculator.josefprusa.cz
@@ -38,11 +55,7 @@ Here are some standard links for getting your machine calibrated:
* http://www.thingiverse.com/thing:5573
* https://sites.google.com/site/repraplogphase/calibration-of-your-reprap
* http://www.thingiverse.com/thing:298812
-*/
-
-// This configuration file contains the basic settings.
-// Advanced settings can be found in Configuration_adv.h
-// BASIC SETTINGS: select your board type, temperature sensor type, axis scaling, and endstop configuration
+ */
//===========================================================================
//============================= DELTA Printer ===============================
diff --git a/Marlin/example_configurations/WITBOX/Configuration_adv.h b/Marlin/example_configurations/WITBOX/Configuration_adv.h
index f828f184eb484e14c392ef12fe2fccea8836da06..2bd84d0b4689679a8b45fc96a992161ed8a373f8 100644
--- a/Marlin/example_configurations/WITBOX/Configuration_adv.h
+++ b/Marlin/example_configurations/WITBOX/Configuration_adv.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,6 +20,16 @@
*
*/
+/**
+ * Configuration_adv.h
+ *
+ * Advanced settings.
+ * Only change these if you know exactly what you're doing.
+ * Some of these settings can damage your printer if improperly set!
+ *
+ * Basic settings can be found in Configuration.h
+ *
+ */
#ifndef CONFIGURATION_ADV_H
#define CONFIGURATION_ADV_H
diff --git a/Marlin/example_configurations/adafruit/ST7565/Configuration.h b/Marlin/example_configurations/adafruit/ST7565/Configuration.h
index ba7c699a1f214500bc174edb308d80b8f80714dd..3dc5017fa9ef1161c663c90ba57e7ee09a8487f3 100644
--- a/Marlin/example_configurations/adafruit/ST7565/Configuration.h
+++ b/Marlin/example_configurations/adafruit/ST7565/Configuration.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,6 +20,21 @@
*
*/
+/**
+ * Configuration.h
+ *
+ * Basic settings such as:
+ *
+ * - Type of electronics
+ * - Type of temperature sensor
+ * - Printer geometry
+ * - Endstop configuration
+ * - LCD controller
+ * - Extra features
+ *
+ * Advanced settings can be found in Configuration_adv.h
+ *
+ */
#ifndef CONFIGURATION_H
#define CONFIGURATION_H
@@ -29,8 +44,10 @@
//===========================================================================
//============================= Getting Started =============================
//===========================================================================
-/*
-Here are some standard links for getting your machine calibrated:
+
+/**
+ * Here are some standard links for getting your machine calibrated:
+ *
* http://reprap.org/wiki/Calibration
* http://youtu.be/wAL9d7FgInk
* http://calculator.josefprusa.cz
@@ -38,11 +55,7 @@ Here are some standard links for getting your machine calibrated:
* http://www.thingiverse.com/thing:5573
* https://sites.google.com/site/repraplogphase/calibration-of-your-reprap
* http://www.thingiverse.com/thing:298812
-*/
-
-// This configuration file contains the basic settings.
-// Advanced settings can be found in Configuration_adv.h
-// BASIC SETTINGS: select your board type, temperature sensor type, axis scaling, and endstop configuration
+ */
//===========================================================================
//============================= DELTA Printer ===============================
diff --git a/Marlin/example_configurations/delta/biv2.5/Configuration.h b/Marlin/example_configurations/delta/biv2.5/Configuration.h
index 2f339cbfa2752b073d13444a3f041a162283681e..3c77b9cf00cf1164aef79feb420a6c680f16a60e 100644
--- a/Marlin/example_configurations/delta/biv2.5/Configuration.h
+++ b/Marlin/example_configurations/delta/biv2.5/Configuration.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,6 +20,21 @@
*
*/
+/**
+ * Configuration.h
+ *
+ * Basic settings such as:
+ *
+ * - Type of electronics
+ * - Type of temperature sensor
+ * - Printer geometry
+ * - Endstop configuration
+ * - LCD controller
+ * - Extra features
+ *
+ * Advanced settings can be found in Configuration_adv.h
+ *
+ */
#ifndef CONFIGURATION_H
#define CONFIGURATION_H
@@ -29,8 +44,10 @@
//===========================================================================
//============================= Getting Started =============================
//===========================================================================
-/*
-Here are some standard links for getting your machine calibrated:
+
+/**
+ * Here are some standard links for getting your machine calibrated:
+ *
* http://reprap.org/wiki/Calibration
* http://youtu.be/wAL9d7FgInk
* http://calculator.josefprusa.cz
@@ -38,11 +55,7 @@ Here are some standard links for getting your machine calibrated:
* http://www.thingiverse.com/thing:5573
* https://sites.google.com/site/repraplogphase/calibration-of-your-reprap
* http://www.thingiverse.com/thing:298812
-*/
-
-// This configuration file contains the basic settings.
-// Advanced settings can be found in Configuration_adv.h
-// BASIC SETTINGS: select your board type, temperature sensor type, axis scaling, and endstop configuration
+ */
//===========================================================================
//============================= DELTA Printer ===============================
diff --git a/Marlin/example_configurations/delta/biv2.5/Configuration_adv.h b/Marlin/example_configurations/delta/biv2.5/Configuration_adv.h
index e0f3e04b7f7a762f905cba0824b46a3db8723208..ea7d782e2fb547c7d328400f4d7011460ed4eee8 100644
--- a/Marlin/example_configurations/delta/biv2.5/Configuration_adv.h
+++ b/Marlin/example_configurations/delta/biv2.5/Configuration_adv.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,6 +20,16 @@
*
*/
+/**
+ * Configuration_adv.h
+ *
+ * Advanced settings.
+ * Only change these if you know exactly what you're doing.
+ * Some of these settings can damage your printer if improperly set!
+ *
+ * Basic settings can be found in Configuration.h
+ *
+ */
#ifndef CONFIGURATION_ADV_H
#define CONFIGURATION_ADV_H
diff --git a/Marlin/example_configurations/delta/generic/Configuration.h b/Marlin/example_configurations/delta/generic/Configuration.h
index 687f9b0b03a8943ad7ea57367a11d18e720edd61..42452f5132421520eea1181073bc32515fe43396 100644
--- a/Marlin/example_configurations/delta/generic/Configuration.h
+++ b/Marlin/example_configurations/delta/generic/Configuration.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,6 +20,21 @@
*
*/
+/**
+ * Configuration.h
+ *
+ * Basic settings such as:
+ *
+ * - Type of electronics
+ * - Type of temperature sensor
+ * - Printer geometry
+ * - Endstop configuration
+ * - LCD controller
+ * - Extra features
+ *
+ * Advanced settings can be found in Configuration_adv.h
+ *
+ */
#ifndef CONFIGURATION_H
#define CONFIGURATION_H
@@ -29,8 +44,10 @@
//===========================================================================
//============================= Getting Started =============================
//===========================================================================
-/*
-Here are some standard links for getting your machine calibrated:
+
+/**
+ * Here are some standard links for getting your machine calibrated:
+ *
* http://reprap.org/wiki/Calibration
* http://youtu.be/wAL9d7FgInk
* http://calculator.josefprusa.cz
@@ -38,11 +55,7 @@ Here are some standard links for getting your machine calibrated:
* http://www.thingiverse.com/thing:5573
* https://sites.google.com/site/repraplogphase/calibration-of-your-reprap
* http://www.thingiverse.com/thing:298812
-*/
-
-// This configuration file contains the basic settings.
-// Advanced settings can be found in Configuration_adv.h
-// BASIC SETTINGS: select your board type, temperature sensor type, axis scaling, and endstop configuration
+ */
//===========================================================================
//============================= DELTA Printer ===============================
diff --git a/Marlin/example_configurations/delta/generic/Configuration_adv.h b/Marlin/example_configurations/delta/generic/Configuration_adv.h
index 7b21d455163b62ea97f677295b5297b493fa5c02..c50f7e8bda62429201148e5452c5dcd8e95569c7 100644
--- a/Marlin/example_configurations/delta/generic/Configuration_adv.h
+++ b/Marlin/example_configurations/delta/generic/Configuration_adv.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,6 +20,16 @@
*
*/
+/**
+ * Configuration_adv.h
+ *
+ * Advanced settings.
+ * Only change these if you know exactly what you're doing.
+ * Some of these settings can damage your printer if improperly set!
+ *
+ * Basic settings can be found in Configuration.h
+ *
+ */
#ifndef CONFIGURATION_ADV_H
#define CONFIGURATION_ADV_H
diff --git a/Marlin/example_configurations/delta/kossel_mini/Configuration.h b/Marlin/example_configurations/delta/kossel_mini/Configuration.h
index 41132655d18ce1385ee2bbf9fa13d5c2261b843e..21a50d3f5b3481a3b7c0659db06f45a97837c93c 100644
--- a/Marlin/example_configurations/delta/kossel_mini/Configuration.h
+++ b/Marlin/example_configurations/delta/kossel_mini/Configuration.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,6 +20,21 @@
*
*/
+/**
+ * Configuration.h
+ *
+ * Basic settings such as:
+ *
+ * - Type of electronics
+ * - Type of temperature sensor
+ * - Printer geometry
+ * - Endstop configuration
+ * - LCD controller
+ * - Extra features
+ *
+ * Advanced settings can be found in Configuration_adv.h
+ *
+ */
#ifndef CONFIGURATION_H
#define CONFIGURATION_H
@@ -29,8 +44,10 @@
//===========================================================================
//============================= Getting Started =============================
//===========================================================================
-/*
-Here are some standard links for getting your machine calibrated:
+
+/**
+ * Here are some standard links for getting your machine calibrated:
+ *
* http://reprap.org/wiki/Calibration
* http://youtu.be/wAL9d7FgInk
* http://calculator.josefprusa.cz
@@ -38,11 +55,7 @@ Here are some standard links for getting your machine calibrated:
* http://www.thingiverse.com/thing:5573
* https://sites.google.com/site/repraplogphase/calibration-of-your-reprap
* http://www.thingiverse.com/thing:298812
-*/
-
-// This configuration file contains the basic settings.
-// Advanced settings can be found in Configuration_adv.h
-// BASIC SETTINGS: select your board type, temperature sensor type, axis scaling, and endstop configuration
+ */
//===========================================================================
//============================= DELTA Printer ===============================
diff --git a/Marlin/example_configurations/delta/kossel_mini/Configuration_adv.h b/Marlin/example_configurations/delta/kossel_mini/Configuration_adv.h
index 702a1a3779df4adb867d523b88b0598f1574bf99..436d8c228faf45259b9da00313dc228d2cd70011 100644
--- a/Marlin/example_configurations/delta/kossel_mini/Configuration_adv.h
+++ b/Marlin/example_configurations/delta/kossel_mini/Configuration_adv.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,6 +20,16 @@
*
*/
+/**
+ * Configuration_adv.h
+ *
+ * Advanced settings.
+ * Only change these if you know exactly what you're doing.
+ * Some of these settings can damage your printer if improperly set!
+ *
+ * Basic settings can be found in Configuration.h
+ *
+ */
#ifndef CONFIGURATION_ADV_H
#define CONFIGURATION_ADV_H
diff --git a/Marlin/example_configurations/delta/kossel_pro/Configuration.h b/Marlin/example_configurations/delta/kossel_pro/Configuration.h
index ea86961639022dc0e7f6067d8cfde7a7cda66444..3e533a4a4c790fbbb29b2a25c4ab67d65cfdb568 100644
--- a/Marlin/example_configurations/delta/kossel_pro/Configuration.h
+++ b/Marlin/example_configurations/delta/kossel_pro/Configuration.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,10 +20,27 @@
*
*/
-// Example configuration file for OpenBeam Kossel Pro
-// tested on 2015-05-19 by @Wackerbarth
-// using Arduino 1.6.5 (Mac)
+/**
+ * Example configuration file for OpenBeam Kossel Pro
+ * tested on 2015-05-19 by @Wackerbarth
+ * using Arduino 1.6.5 (Mac)
+ */
+/**
+ * Configuration.h
+ *
+ * Basic settings such as:
+ *
+ * - Type of electronics
+ * - Type of temperature sensor
+ * - Printer geometry
+ * - Endstop configuration
+ * - LCD controller
+ * - Extra features
+ *
+ * Advanced settings can be found in Configuration_adv.h
+ *
+ */
#ifndef CONFIGURATION_H
#define CONFIGURATION_H
@@ -33,8 +50,10 @@
//===========================================================================
//============================= Getting Started =============================
//===========================================================================
-/*
-Here are some standard links for getting your machine calibrated:
+
+/**
+ * Here are some standard links for getting your machine calibrated:
+ *
* http://reprap.org/wiki/Calibration
* http://youtu.be/wAL9d7FgInk
* http://calculator.josefprusa.cz
@@ -42,11 +61,7 @@ Here are some standard links for getting your machine calibrated:
* http://www.thingiverse.com/thing:5573
* https://sites.google.com/site/repraplogphase/calibration-of-your-reprap
* http://www.thingiverse.com/thing:298812
-*/
-
-// This configuration file contains the basic settings.
-// Advanced settings can be found in Configuration_adv.h
-// BASIC SETTINGS: select your board type, temperature sensor type, axis scaling, and endstop configuration
+ */
//===========================================================================
//============================= DELTA Printer ===============================
diff --git a/Marlin/example_configurations/delta/kossel_pro/Configuration_adv.h b/Marlin/example_configurations/delta/kossel_pro/Configuration_adv.h
index 58e0c710bf437e1ef5db29bbd51a657f05265dbb..f7cb980b421ef0066d8d0dec896dc93fbfb3c7d2 100644
--- a/Marlin/example_configurations/delta/kossel_pro/Configuration_adv.h
+++ b/Marlin/example_configurations/delta/kossel_pro/Configuration_adv.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -24,6 +24,17 @@
// tested on 2015-05-19 by @Wackerbarth
// using Arduino 1.6.5 (Mac)
+
+/**
+ * Configuration_adv.h
+ *
+ * Advanced settings.
+ * Only change these if you know exactly what you're doing.
+ * Some of these settings can damage your printer if improperly set!
+ *
+ * Basic settings can be found in Configuration.h
+ *
+ */
#ifndef CONFIGURATION_ADV_H
#define CONFIGURATION_ADV_H
diff --git a/Marlin/example_configurations/delta/kossel_xl/Configuration.h b/Marlin/example_configurations/delta/kossel_xl/Configuration.h
index 9a508859ad550a9778c88c189c7609b539a19c7a..ae8cdf6fef6918079ebe3a83f26eda2f0579caeb 100644
--- a/Marlin/example_configurations/delta/kossel_xl/Configuration.h
+++ b/Marlin/example_configurations/delta/kossel_xl/Configuration.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,6 +20,21 @@
*
*/
+/**
+ * Configuration.h
+ *
+ * Basic settings such as:
+ *
+ * - Type of electronics
+ * - Type of temperature sensor
+ * - Printer geometry
+ * - Endstop configuration
+ * - LCD controller
+ * - Extra features
+ *
+ * Advanced settings can be found in Configuration_adv.h
+ *
+ */
#ifndef CONFIGURATION_H
#define CONFIGURATION_H
@@ -29,8 +44,10 @@
//===========================================================================
//============================= Getting Started =============================
//===========================================================================
-/*
-Here are some standard links for getting your machine calibrated:
+
+/**
+ * Here are some standard links for getting your machine calibrated:
+ *
* http://reprap.org/wiki/Calibration
* http://youtu.be/wAL9d7FgInk
* http://calculator.josefprusa.cz
@@ -38,11 +55,7 @@ Here are some standard links for getting your machine calibrated:
* http://www.thingiverse.com/thing:5573
* https://sites.google.com/site/repraplogphase/calibration-of-your-reprap
* http://www.thingiverse.com/thing:298812
-*/
-
-// This configuration file contains the basic settings.
-// Advanced settings can be found in Configuration_adv.h
-// BASIC SETTINGS: select your board type, temperature sensor type, axis scaling, and endstop configuration
+ */
//===========================================================================
//============================= DELTA Printer ===============================
diff --git a/Marlin/example_configurations/delta/kossel_xl/Configuration_adv.h b/Marlin/example_configurations/delta/kossel_xl/Configuration_adv.h
index 13787554169b5c4ffe3a6a5333e7629994ac6896..8fd808419a713fedf6361c028e198dca5bb4e7f3 100644
--- a/Marlin/example_configurations/delta/kossel_xl/Configuration_adv.h
+++ b/Marlin/example_configurations/delta/kossel_xl/Configuration_adv.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,6 +20,16 @@
*
*/
+/**
+ * Configuration_adv.h
+ *
+ * Advanced settings.
+ * Only change these if you know exactly what you're doing.
+ * Some of these settings can damage your printer if improperly set!
+ *
+ * Basic settings can be found in Configuration.h
+ *
+ */
#ifndef CONFIGURATION_ADV_H
#define CONFIGURATION_ADV_H
diff --git a/Marlin/example_configurations/makibox/Configuration.h b/Marlin/example_configurations/makibox/Configuration.h
index 5854acd99e535e96642e3b163ff79ac412c8631d..7ce56ede05fae762c13e61192cae555694791997 100644
--- a/Marlin/example_configurations/makibox/Configuration.h
+++ b/Marlin/example_configurations/makibox/Configuration.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,6 +20,21 @@
*
*/
+/**
+ * Configuration.h
+ *
+ * Basic settings such as:
+ *
+ * - Type of electronics
+ * - Type of temperature sensor
+ * - Printer geometry
+ * - Endstop configuration
+ * - LCD controller
+ * - Extra features
+ *
+ * Advanced settings can be found in Configuration_adv.h
+ *
+ */
#ifndef CONFIGURATION_H
#define CONFIGURATION_H
@@ -29,8 +44,10 @@
//===========================================================================
//============================= Getting Started =============================
//===========================================================================
-/*
-Here are some standard links for getting your machine calibrated:
+
+/**
+ * Here are some standard links for getting your machine calibrated:
+ *
* http://reprap.org/wiki/Calibration
* http://youtu.be/wAL9d7FgInk
* http://calculator.josefprusa.cz
@@ -38,11 +55,7 @@ Here are some standard links for getting your machine calibrated:
* http://www.thingiverse.com/thing:5573
* https://sites.google.com/site/repraplogphase/calibration-of-your-reprap
* http://www.thingiverse.com/thing:298812
-*/
-
-// This configuration file contains the basic settings.
-// Advanced settings can be found in Configuration_adv.h
-// BASIC SETTINGS: select your board type, temperature sensor type, axis scaling, and endstop configuration
+ */
//===========================================================================
//============================= DELTA Printer ===============================
diff --git a/Marlin/example_configurations/makibox/Configuration_adv.h b/Marlin/example_configurations/makibox/Configuration_adv.h
index 1d4bc409f6cb779525d961c83192dca1b4a6176f..8ec4d870a8977259e28d6f8ad7cb81722d5da04c 100644
--- a/Marlin/example_configurations/makibox/Configuration_adv.h
+++ b/Marlin/example_configurations/makibox/Configuration_adv.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,6 +20,16 @@
*
*/
+/**
+ * Configuration_adv.h
+ *
+ * Advanced settings.
+ * Only change these if you know exactly what you're doing.
+ * Some of these settings can damage your printer if improperly set!
+ *
+ * Basic settings can be found in Configuration.h
+ *
+ */
#ifndef CONFIGURATION_ADV_H
#define CONFIGURATION_ADV_H
diff --git a/Marlin/example_configurations/tvrrug/Round2/Configuration.h b/Marlin/example_configurations/tvrrug/Round2/Configuration.h
index 8ababd37c2f7eb97927085ccf273f2d3510364a0..b1d212b6c6e857757607691233df14f77b996baa 100644
--- a/Marlin/example_configurations/tvrrug/Round2/Configuration.h
+++ b/Marlin/example_configurations/tvrrug/Round2/Configuration.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,6 +20,21 @@
*
*/
+/**
+ * Configuration.h
+ *
+ * Basic settings such as:
+ *
+ * - Type of electronics
+ * - Type of temperature sensor
+ * - Printer geometry
+ * - Endstop configuration
+ * - LCD controller
+ * - Extra features
+ *
+ * Advanced settings can be found in Configuration_adv.h
+ *
+ */
#ifndef CONFIGURATION_H
#define CONFIGURATION_H
@@ -29,8 +44,10 @@
//===========================================================================
//============================= Getting Started =============================
//===========================================================================
-/*
-Here are some standard links for getting your machine calibrated:
+
+/**
+ * Here are some standard links for getting your machine calibrated:
+ *
* http://reprap.org/wiki/Calibration
* http://youtu.be/wAL9d7FgInk
* http://calculator.josefprusa.cz
@@ -38,11 +55,7 @@ Here are some standard links for getting your machine calibrated:
* http://www.thingiverse.com/thing:5573
* https://sites.google.com/site/repraplogphase/calibration-of-your-reprap
* http://www.thingiverse.com/thing:298812
-*/
-
-// This configuration file contains the basic settings.
-// Advanced settings can be found in Configuration_adv.h
-// BASIC SETTINGS: select your board type, temperature sensor type, axis scaling, and endstop configuration
+ */
//===========================================================================
//============================= DELTA Printer ===============================
diff --git a/Marlin/example_configurations/tvrrug/Round2/Configuration_adv.h b/Marlin/example_configurations/tvrrug/Round2/Configuration_adv.h
index 0409216da59ce7642022a3f5d7177bd773205a35..f8630f0aeceae80ae5941b3b6c4f8536a41a8c78 100644
--- a/Marlin/example_configurations/tvrrug/Round2/Configuration_adv.h
+++ b/Marlin/example_configurations/tvrrug/Round2/Configuration_adv.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,6 +20,16 @@
*
*/
+/**
+ * Configuration_adv.h
+ *
+ * Advanced settings.
+ * Only change these if you know exactly what you're doing.
+ * Some of these settings can damage your printer if improperly set!
+ *
+ * Basic settings can be found in Configuration.h
+ *
+ */
#ifndef CONFIGURATION_ADV_H
#define CONFIGURATION_ADV_H
diff --git a/Marlin/fastio.h b/Marlin/fastio.h
index 053113f997a11d7467111e1dbf8fce20aa75f25d..fe8fa70e952f82d6bb6b8adfd58faef29e69015f 100644
--- a/Marlin/fastio.h
+++ b/Marlin/fastio.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,7 +20,7 @@
*
*/
-/*
+/**
This code contributed by Triffid_Hunter and modified by Kliment
why double up on these macros? see http://gcc.gnu.org/onlinedocs/cpp/Stringification.html
*/
@@ -30,7 +30,7 @@
#include <avr/io.h>
-/*
+/**
utility functions
*/
@@ -38,7 +38,7 @@
#define MASK(PIN) (1 << PIN)
#endif
-/*
+/**
magic I/O routines
now you can simply SET_OUTPUT(STEP); WRITE(STEP, 1); WRITE(STEP, 0);
*/
@@ -107,7 +107,7 @@
// Shorthand
#define OUT_WRITE(IO, v) { SET_OUTPUT(IO); WRITE(IO, v); }
-/*
+/**
ports and functions
added as necessary or if I feel like it- not a comprehensive list!
@@ -138,7 +138,7 @@
#define DEBUG_LED AIO5
- /*
+ /**
pins
*/
@@ -477,7 +477,7 @@
#define OC2B DIO14
#define DEBUG_LED DIO0
- /*
+ /**
pins
*/
@@ -986,7 +986,7 @@
// change for your board
#define DEBUG_LED DIO21
- /*
+ /**
pins
*/
#define DIO0_PIN PINE0
@@ -2056,7 +2056,7 @@
// change for your board
#define DEBUG_LED DIO31 /* led D5 red */
- /*
+ /**
pins
*/
@@ -2698,7 +2698,7 @@
#else // AT90USBxx_TEENSYPP_ASSIGNMENTS -- Use Teensyduino Teensy++2.0 assignments.
- /*
+ /**
AT90USB 51 50 49 48 47 46 45 44 10 11 12 13 14 15 16 17 35 36 37 38 39 40 41 42 25 26 27 28 29 30 31 32 33 34 43 09 18 19 01 02 61 60 59 58 57 56 55 54
Port A0 A1 A2 A3 A4 A5 A6 A7 B0 B1 B2 B3 B4 B5 B6 B7 C0 C1 C2 C3 C4 C5 C6 C7 D0 D1 D2 D3 D4 D5 D6 D7 E0 E1 E2 E3 E4 E5 E6 E7 F0 F1 F2 F3 F4 F5 F6 F7
@@ -3373,7 +3373,7 @@
// change for your board
#define DEBUG_LED DIO46
- /*
+ /**
pins
*/
#define DIO0_PIN PINE0
diff --git a/Marlin/language.h b/Marlin/language.h
index f3ca13f39ed74d94e8a5f112f70ff024abe33aad..1b82ec314c830dfbf984c269ba12558b1d448010 100644
--- a/Marlin/language.h
+++ b/Marlin/language.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/language_an.h b/Marlin/language_an.h
index cf7a8a9e5ccea9c60ccf697b95c7010d147cb159..ab93671dc04df707b111ab2d2e03b1f4c6be4d4a 100644
--- a/Marlin/language_an.h
+++ b/Marlin/language_an.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/language_bg.h b/Marlin/language_bg.h
index fadef863c8fd3b0b24fe168cd87f89e56310fc3c..c6007dba36d7170e5773f401b8d43590d21887b9 100644
--- a/Marlin/language_bg.h
+++ b/Marlin/language_bg.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/language_ca.h b/Marlin/language_ca.h
index d7db26d32e795f0c62221c234ffb5bc0f5b9397c..f08e29e32b487c94d9d34a3168ee515820e3061a 100644
--- a/Marlin/language_ca.h
+++ b/Marlin/language_ca.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/language_cn.h b/Marlin/language_cn.h
index ed386493c3d9cda870ceb9dbc0d1ce7804434b8f..e6a0ccf0afb630c27f1ac512cf75f8c80901a1c7 100644
--- a/Marlin/language_cn.h
+++ b/Marlin/language_cn.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/language_cz.h b/Marlin/language_cz.h
index f7464d221d8eb1ce9e4d0505d2b67a8a21ace826..6555aa01ea76636bbe754c787b5c62ebe4b4d0c5 100644
--- a/Marlin/language_cz.h
+++ b/Marlin/language_cz.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/language_da.h b/Marlin/language_da.h
index da0d6bdc6444c9fcc658c2926d7ddf2a36501167..e47fd1c8fae8e3ca104eedd0deb1dfab07efb8cd 100644
--- a/Marlin/language_da.h
+++ b/Marlin/language_da.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/language_de.h b/Marlin/language_de.h
index 254034665da839f305b0924a7c067ddd9d1cadb9..3d791e2d35d451b7fe8210c413eaf88255d30f8c 100644
--- a/Marlin/language_de.h
+++ b/Marlin/language_de.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/language_en.h b/Marlin/language_en.h
index 38cc8957e82c3d5cc8aa4c69f0b1ae4d901e6153..b4eb6d5cdf9318ffd49cc1ddbee63e7392fa2783 100644
--- a/Marlin/language_en.h
+++ b/Marlin/language_en.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/language_es.h b/Marlin/language_es.h
index 2401e618d584a7c032aa7ba2d534e923b4c247d6..a8c4fc803c376baafd15dc94c159ad78ce838d9c 100644
--- a/Marlin/language_es.h
+++ b/Marlin/language_es.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/language_eu.h b/Marlin/language_eu.h
index 0223f144c6f48a6aca7fbadd65906e359833ac58..28e0e0c034b20981a34bc99032eee52270a4e62d 100644
--- a/Marlin/language_eu.h
+++ b/Marlin/language_eu.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/language_fi.h b/Marlin/language_fi.h
index 8d23775c5b3d702c7c1a70c0651e06c7782ff07d..b6f7de6fd8b445ecb255d7364f5509494d8859af 100644
--- a/Marlin/language_fi.h
+++ b/Marlin/language_fi.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/language_fr.h b/Marlin/language_fr.h
index be4fce765665863d211461945610bc80fc4a51e5..11aaf95754477d7bbceff5de497a0906c85a284f 100644
--- a/Marlin/language_fr.h
+++ b/Marlin/language_fr.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/language_gl.h b/Marlin/language_gl.h
index c26e19c328a75ff11ee681854e864bae91f4232f..2a159353090fb47bd383d5e515300fd33d8e48c5 100644
--- a/Marlin/language_gl.h
+++ b/Marlin/language_gl.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/language_it.h b/Marlin/language_it.h
index 1056554c19b378108024caeb40e87ac20b95e10f..23ad7c6c56225bb3d2ec9faa2a083101deb4587b 100644
--- a/Marlin/language_it.h
+++ b/Marlin/language_it.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/language_kana.h b/Marlin/language_kana.h
index 40bfd96efa1befab4af821fa53ae1ebfbb295cab..fca13e9294ea4ab640746507ad68c6f3fab7774f 100644
--- a/Marlin/language_kana.h
+++ b/Marlin/language_kana.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/language_kana_utf8.h b/Marlin/language_kana_utf8.h
index 75763318a9b51eb8ccff348a295b0e6a9d792ef5..4ca47a8e7337ec98bec1ccbd0e9f156dd102e934 100644
--- a/Marlin/language_kana_utf8.h
+++ b/Marlin/language_kana_utf8.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/language_nl.h b/Marlin/language_nl.h
index 34a23510a8063100e314aee4da3a4d6292f8df56..27aefee013309061c95f26afc49a241a877bd4f1 100644
--- a/Marlin/language_nl.h
+++ b/Marlin/language_nl.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/language_pl.h b/Marlin/language_pl.h
index f5d63a8d08d3a3d35f74e375f930d60e54888f5c..37586f53a298e8defeca21db090f56d26fb207c8 100644
--- a/Marlin/language_pl.h
+++ b/Marlin/language_pl.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/language_pt-br.h b/Marlin/language_pt-br.h
index 8a6567bbff07b044d6ee2b143f7b476106135dff..3e882635fc1d416cb7ee8560bb3dc8ee26e780d9 100644
--- a/Marlin/language_pt-br.h
+++ b/Marlin/language_pt-br.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/language_pt-br_utf8.h b/Marlin/language_pt-br_utf8.h
index 5f08e846e363af0f85b747a726d07acbde8c2250..7b6639bd04e295e928829a5f602cc960bd8fe3fd 100644
--- a/Marlin/language_pt-br_utf8.h
+++ b/Marlin/language_pt-br_utf8.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/language_pt.h b/Marlin/language_pt.h
index eb3cb9dd84088ed9366b365462330403c35d80a9..5070c93eacd0b08502af5ba268b9a2ee765d1282 100644
--- a/Marlin/language_pt.h
+++ b/Marlin/language_pt.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/language_pt_utf8.h b/Marlin/language_pt_utf8.h
index 2cc7cc2db9fab66ffcefabd31dbd03d4bce62953..64da9645d0db444be89e8ff415d55f4c07dfc74e 100644
--- a/Marlin/language_pt_utf8.h
+++ b/Marlin/language_pt_utf8.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/language_ru.h b/Marlin/language_ru.h
index d2076b3a7acc6902c7439f149464a797f0d233f2..fe04c03aae4717355777060d467cf02671585e9a 100644
--- a/Marlin/language_ru.h
+++ b/Marlin/language_ru.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/language_test.h b/Marlin/language_test.h
index f8ebacaa981813ab3d75d7270343c29a2b57a7ed..3444ee502917db4f9f7845164b94d78bd275f2f4 100644
--- a/Marlin/language_test.h
+++ b/Marlin/language_test.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/macros.h b/Marlin/macros.h
index 4318a4ddabab8355b07603526fbb1f3982e23f49..966fc48d02535f695c04fdf366ea8c166119d8cc 100644
--- a/Marlin/macros.h
+++ b/Marlin/macros.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/mesh_bed_leveling.cpp b/Marlin/mesh_bed_leveling.cpp
index c6d168ae3b78b3d8d1973aa932cf095ec61fb293..462c6c6866e856be6a00b34c4cccf5f06dee06d6 100644
--- a/Marlin/mesh_bed_leveling.cpp
+++ b/Marlin/mesh_bed_leveling.cpp
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/mesh_bed_leveling.h b/Marlin/mesh_bed_leveling.h
index f9a8e7274677cb31d5882a0a78f32042dc45af2a..d531ff5162e5e129aed3b3769f048e0ff6788ebf 100644
--- a/Marlin/mesh_bed_leveling.h
+++ b/Marlin/mesh_bed_leveling.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins.h b/Marlin/pins.h
index b4f1c397823882bbfd501b3ebe8895d1ce1080c5..b116364628144ab6d38d433cf55719926ddf4576 100644
--- a/Marlin/pins.h
+++ b/Marlin/pins.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_3DRAG.h b/Marlin/pins_3DRAG.h
index 1c8997ace0c8192178a1b7c3a4976e7f691e1a15..e3175a2402eee8f685ba278ebc1dc0496f345636 100644
--- a/Marlin/pins_3DRAG.h
+++ b/Marlin/pins_3DRAG.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_5DPRINT.h b/Marlin/pins_5DPRINT.h
index 425f46ced22b60b38024da965c215f501e6bb1d6..14a5d4d7d5965335f7fdfa1e0434e9b876362bbb 100644
--- a/Marlin/pins_5DPRINT.h
+++ b/Marlin/pins_5DPRINT.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_99.h b/Marlin/pins_99.h
index 4ac464b805a47adc155fc3203b5c9f72bda29611..1b050573f6857fc32027a9028a02eec0251160a2 100644
--- a/Marlin/pins_99.h
+++ b/Marlin/pins_99.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_A4JP.h b/Marlin/pins_A4JP.h
index 19c3a96a3f07152044d3929147bf97b0f6e81437..2e36db59573380eabc49ea7c756a75e6cc2cfc34 100644
--- a/Marlin/pins_A4JP.h
+++ b/Marlin/pins_A4JP.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_AZTEEG_X1.h b/Marlin/pins_AZTEEG_X1.h
index 12bb7caf91f4b0eb0ee01e3ab63a370c5ec55774..21bb491f5b867d6b58300067a244a4033ac89837 100644
--- a/Marlin/pins_AZTEEG_X1.h
+++ b/Marlin/pins_AZTEEG_X1.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_AZTEEG_X3.h b/Marlin/pins_AZTEEG_X3.h
index fe9bcadf12c78e1b1f875be5a98afd94e5ff6edd..2668d09134d7ae5ca8a156a182e9af25160f6ccb 100644
--- a/Marlin/pins_AZTEEG_X3.h
+++ b/Marlin/pins_AZTEEG_X3.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_AZTEEG_X3_PRO.h b/Marlin/pins_AZTEEG_X3_PRO.h
index 2a6b2fa792e0afa6c8b7828f19b8a88a5c9d2416..a184ec2b978aeb58ca8a1837d8a45526bdd14257 100644
--- a/Marlin/pins_AZTEEG_X3_PRO.h
+++ b/Marlin/pins_AZTEEG_X3_PRO.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_BAM_DICE_DUE.h b/Marlin/pins_BAM_DICE_DUE.h
index 3f28f232c11b0d14ff3c6feef453661b22194047..355daf5c1d9579786251f77da6b734201cebe4a3 100644
--- a/Marlin/pins_BAM_DICE_DUE.h
+++ b/Marlin/pins_BAM_DICE_DUE.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_BQ_ZUM_MEGA_3D.h b/Marlin/pins_BQ_ZUM_MEGA_3D.h
index f73375ed9db08482628e77499cdd78d019107c2e..d8ea114613ba1447482bf2591717161527ac743f 100644
--- a/Marlin/pins_BQ_ZUM_MEGA_3D.h
+++ b/Marlin/pins_BQ_ZUM_MEGA_3D.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_BRAINWAVE.h b/Marlin/pins_BRAINWAVE.h
index 03acdaf59ae5bbc87646dc910d409ee368372e02..a02b6515f499a0521311f1de80c65c0cce2c5a63 100644
--- a/Marlin/pins_BRAINWAVE.h
+++ b/Marlin/pins_BRAINWAVE.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_BRAINWAVE_PRO.h b/Marlin/pins_BRAINWAVE_PRO.h
index 27cdb780c921d7e72af5829f1504796d08502124..c79f04eb65fbbc09adb5c4b6ed4dc5504b77478d 100644
--- a/Marlin/pins_BRAINWAVE_PRO.h
+++ b/Marlin/pins_BRAINWAVE_PRO.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_CHEAPTRONIC.h b/Marlin/pins_CHEAPTRONIC.h
index 270297f1465e23ab29b320c0333b595279f6a101..1bbd979520cd194c693c51d1785c737ee9e9ce23 100644
--- a/Marlin/pins_CHEAPTRONIC.h
+++ b/Marlin/pins_CHEAPTRONIC.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_ELEFU_3.h b/Marlin/pins_ELEFU_3.h
index 45444aa9cebae2080ba547a8b85d470da8ed8b65..23f8b944f115119426b7d5aed327116aa086eadb 100644
--- a/Marlin/pins_ELEFU_3.h
+++ b/Marlin/pins_ELEFU_3.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_FELIX2.h b/Marlin/pins_FELIX2.h
index 9287fbd41b6a71f03de0369023ff7c79b489ff9d..79d8332ada16a1ac78ffd0fa3800820e19925ed7 100644
--- a/Marlin/pins_FELIX2.h
+++ b/Marlin/pins_FELIX2.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_GEN3_MONOLITHIC.h b/Marlin/pins_GEN3_MONOLITHIC.h
index ca876ff8006d5c0e25d3af148bbb21f19257afe6..ba61fd2a6871778553b96c9038ec33cf2009065f 100644
--- a/Marlin/pins_GEN3_MONOLITHIC.h
+++ b/Marlin/pins_GEN3_MONOLITHIC.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_GEN3_PLUS.h b/Marlin/pins_GEN3_PLUS.h
index eb3a7f158228e0201ddd0d7d1c2275af74ef384b..15241bfb53884fd7a6be436e560371356bc3f47d 100644
--- a/Marlin/pins_GEN3_PLUS.h
+++ b/Marlin/pins_GEN3_PLUS.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_GEN6.h b/Marlin/pins_GEN6.h
index 042095e4861a013602abc5f1a7419f4e9138199b..6d1ce468da564862e493709ad64f36043d154af7 100644
--- a/Marlin/pins_GEN6.h
+++ b/Marlin/pins_GEN6.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_GEN6_DELUXE.h b/Marlin/pins_GEN6_DELUXE.h
index 647dcd20edfc109406b92ac808a85e6703d68d38..718f517c6bf7157fd39444db0444bfac07708d96 100644
--- a/Marlin/pins_GEN6_DELUXE.h
+++ b/Marlin/pins_GEN6_DELUXE.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_GEN7_12.h b/Marlin/pins_GEN7_12.h
index 488f6402c4369faeb3ebfc304a5c332e35e5f01d..0c23c064829e7716ef078e6083b90d4c9e314456 100644
--- a/Marlin/pins_GEN7_12.h
+++ b/Marlin/pins_GEN7_12.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_GEN7_13.h b/Marlin/pins_GEN7_13.h
index 9a721e21dc84d3a5c1bf131834b8f5c8bb27e58b..5887aeca8e7266aa1c9cfb9ee291b731f0a2f8e6 100644
--- a/Marlin/pins_GEN7_13.h
+++ b/Marlin/pins_GEN7_13.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_GEN7_14.h b/Marlin/pins_GEN7_14.h
index 697bd806b49a9f8eacc0f81d977165d1d64f8ef8..04a4fce1acf5bea4f27c14d36b16f982ef6e6ce4 100644
--- a/Marlin/pins_GEN7_14.h
+++ b/Marlin/pins_GEN7_14.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_GEN7_CUSTOM.h b/Marlin/pins_GEN7_CUSTOM.h
index dcaa3264efe68e164aff7b755f1e159fb5066488..9150a41b9ebd8446004e16ef0089991c3bb44d1f 100644
--- a/Marlin/pins_GEN7_CUSTOM.h
+++ b/Marlin/pins_GEN7_CUSTOM.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_K8200.h b/Marlin/pins_K8200.h
index e6d7ba436d15f2ddfd3552309453d8af83a025c8..6aab9caed2d406a46f2d87bddab1ac09623f46ea 100644
--- a/Marlin/pins_K8200.h
+++ b/Marlin/pins_K8200.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_LEAPFROG.h b/Marlin/pins_LEAPFROG.h
index 8366b6971ceb14fd567f20785599de601e809b13..8d1a2401a9abdc818208b387cb82f2e83b111c8b 100644
--- a/Marlin/pins_LEAPFROG.h
+++ b/Marlin/pins_LEAPFROG.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_MEGACONTROLLER.h b/Marlin/pins_MEGACONTROLLER.h
index c58a28d65cd383f0780f951c367b0294bd85d6fc..61cd91be01c6e8f1cc28d65424970f68319e8e0a 100644
--- a/Marlin/pins_MEGACONTROLLER.h
+++ b/Marlin/pins_MEGACONTROLLER.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_MEGATRONICS.h b/Marlin/pins_MEGATRONICS.h
index 99d87b0a00710f1f10ecdb4282ea9647ae5d3665..e25cf8a55b5b00c37f588d99b8099b2ef2f76e26 100644
--- a/Marlin/pins_MEGATRONICS.h
+++ b/Marlin/pins_MEGATRONICS.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_MEGATRONICS_2.h b/Marlin/pins_MEGATRONICS_2.h
index ea1683d6eb929b41483d1e17e5a4af50dded069b..186f154275d1a8fe1facf7f2fd5a5086687a79dd 100644
--- a/Marlin/pins_MEGATRONICS_2.h
+++ b/Marlin/pins_MEGATRONICS_2.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_MEGATRONICS_3.h b/Marlin/pins_MEGATRONICS_3.h
index 3a7c3788981d076aa9c1a96a0bb20881d051827a..c60f3c6339e9e522bf99f7e05c1c2a2854fb9ebd 100644
--- a/Marlin/pins_MEGATRONICS_3.h
+++ b/Marlin/pins_MEGATRONICS_3.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_MELZI.h b/Marlin/pins_MELZI.h
index 96de98b237c6039e34307f04b0775e66663c0b28..dae033bf8994fb74c482c257a9c70927fe8308a7 100644
--- a/Marlin/pins_MELZI.h
+++ b/Marlin/pins_MELZI.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_MELZI_MAKR3D.h b/Marlin/pins_MELZI_MAKR3D.h
index d878f6f4ecf126ee27388f477c6d26f049eb352c..fe77e27bc9c5bfba6b0606c7a2b9faea4977c5ff 100644
--- a/Marlin/pins_MELZI_MAKR3D.h
+++ b/Marlin/pins_MELZI_MAKR3D.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_MINIRAMBO.h b/Marlin/pins_MINIRAMBO.h
index 2a96d5ec959998681d739d4db09489b76e7af479..a67dd9c3a80f00fb5a028280d980570c48ec3a2b 100644
--- a/Marlin/pins_MINIRAMBO.h
+++ b/Marlin/pins_MINIRAMBO.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_MINITRONICS.h b/Marlin/pins_MINITRONICS.h
index 5e4d1224966a91c51f1a00370bea8df465e5876e..8bd7b5fc1e6f6fdac8371075929d2b42d12421ce 100644
--- a/Marlin/pins_MINITRONICS.h
+++ b/Marlin/pins_MINITRONICS.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_MKS_BASE.h b/Marlin/pins_MKS_BASE.h
index fa2bfb60e27002ad26d8578dfff1265c6bb41c46..5ca8e05b9282722fb743e8945027ebe826d225fd 100644
--- a/Marlin/pins_MKS_BASE.h
+++ b/Marlin/pins_MKS_BASE.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_OMCA.h b/Marlin/pins_OMCA.h
index 02d3b7c2449326cf35ff419d9de7145079b90efa..e98439608f3ccc68fecdd09c8d1abf5832c56eab 100644
--- a/Marlin/pins_OMCA.h
+++ b/Marlin/pins_OMCA.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_OMCA_A.h b/Marlin/pins_OMCA_A.h
index 49405edcfee1aeaeb6832b07a8b593042e28f3b1..147006de75bb4119c7a1a2300dce0e2484c02193 100644
--- a/Marlin/pins_OMCA_A.h
+++ b/Marlin/pins_OMCA_A.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_PRINTRBOARD.h b/Marlin/pins_PRINTRBOARD.h
index 72f73b53356575c2ecc1f2d0e3aaa2675a40926b..893351710791dc609c1f0efd179f88a59cfbf149 100644
--- a/Marlin/pins_PRINTRBOARD.h
+++ b/Marlin/pins_PRINTRBOARD.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_PRINTRBOARD_REVF.h b/Marlin/pins_PRINTRBOARD_REVF.h
index 3b3dab579c7e65cbd32a62dbdb845dfa4fc77541..d0c6fdb9ed57e245f479343086d319173fbb0069 100644
--- a/Marlin/pins_PRINTRBOARD_REVF.h
+++ b/Marlin/pins_PRINTRBOARD_REVF.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_RAMBO.h b/Marlin/pins_RAMBO.h
index bb2d283ae3c4d12f78c3aff07a850b55eb67807d..b7486931677cfe129dcd58bce87cd08a3dc83730 100644
--- a/Marlin/pins_RAMBO.h
+++ b/Marlin/pins_RAMBO.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_RAMPS_13.h b/Marlin/pins_RAMPS_13.h
index f4b10da0f8acaa041897f12bf97eedc895504dfd..5655f35a1499d7fcf3d058d637b278f226a0d031 100644
--- a/Marlin/pins_RAMPS_13.h
+++ b/Marlin/pins_RAMPS_13.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_RAMPS_13_EFB.h b/Marlin/pins_RAMPS_13_EFB.h
index 9ba72ef55d88401becf84b66f3b1301080e4c410..e0bea37e7f9ab7298d673d4a9a1b6e97129950d0 100644
--- a/Marlin/pins_RAMPS_13_EFB.h
+++ b/Marlin/pins_RAMPS_13_EFB.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_RAMPS_14.h b/Marlin/pins_RAMPS_14.h
index cfd900d10932d35fce629701126feab072165745..9354cc24534e85d714b92146b264c21ac804cf6c 100644
--- a/Marlin/pins_RAMPS_14.h
+++ b/Marlin/pins_RAMPS_14.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_RAMPS_14_EFB.h b/Marlin/pins_RAMPS_14_EFB.h
index ccfda8e9f3c40db4045dd26855ad79182f392368..a43e4d227805b8bcf83ee9efdace2e1a9ca57ac6 100644
--- a/Marlin/pins_RAMPS_14_EFB.h
+++ b/Marlin/pins_RAMPS_14_EFB.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_RAMPS_OLD.h b/Marlin/pins_RAMPS_OLD.h
index 7f7bf3ed4951d5eb1cd6cd04d209fb3b67c1a605..25193c8ed869ee322cf244b2888bf50bb0286ea0 100644
--- a/Marlin/pins_RAMPS_OLD.h
+++ b/Marlin/pins_RAMPS_OLD.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_RIGIDBOARD.h b/Marlin/pins_RIGIDBOARD.h
index 411a2884a4201a972fed9c4e153bade429ba5b56..69ce67d87fe3373a6d645a4dbeaef5c5407ae569 100644
--- a/Marlin/pins_RIGIDBOARD.h
+++ b/Marlin/pins_RIGIDBOARD.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_RUMBA.h b/Marlin/pins_RUMBA.h
index a594fbd8913d3b5a3552a434edfcc644270ab3e2..e2d1e209fb7d32004fdf4c62ce1b78cbdd1a3ae5 100644
--- a/Marlin/pins_RUMBA.h
+++ b/Marlin/pins_RUMBA.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_SANGUINOLOLU_11.h b/Marlin/pins_SANGUINOLOLU_11.h
index b219566ec1a57a3fb8eebb7b3a4f16e89fef0f7d..d848548787928c063666a125c835476d0b039fef 100644
--- a/Marlin/pins_SANGUINOLOLU_11.h
+++ b/Marlin/pins_SANGUINOLOLU_11.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_SANGUINOLOLU_12.h b/Marlin/pins_SANGUINOLOLU_12.h
index 2a25ad1103a8ec79384add31027b4ed1c953f9eb..84d86275e9c1481b500ae188bbd4630b4d3fa16e 100644
--- a/Marlin/pins_SANGUINOLOLU_12.h
+++ b/Marlin/pins_SANGUINOLOLU_12.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_SAV_MKI.h b/Marlin/pins_SAV_MKI.h
index 3807dc25b209a6329e899215aaa1ab68677b0f39..4c14fa6e2d874f3614ec6d74dbc5153fb29d330c 100644
--- a/Marlin/pins_SAV_MKI.h
+++ b/Marlin/pins_SAV_MKI.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_SETHI.h b/Marlin/pins_SETHI.h
index 353e1a2be3f356bef5426e4c34e13cb7aec00254..e16b45cea231a204eb0e1dfc9b720770167cf5f9 100644
--- a/Marlin/pins_SETHI.h
+++ b/Marlin/pins_SETHI.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_STB_11.h b/Marlin/pins_STB_11.h
index 487c73453f31b8e6892ac458aef0f728d9c4129e..9ca93a3f70010edbcc8db0a85fabc1a3e25d8179 100644
--- a/Marlin/pins_STB_11.h
+++ b/Marlin/pins_STB_11.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_TEENSY2.h b/Marlin/pins_TEENSY2.h
index b75606871b811c25aed54cab044f522d0c01f930..eb27ae97d60fa4719821eb7703f283bf4d5f46cb 100644
--- a/Marlin/pins_TEENSY2.h
+++ b/Marlin/pins_TEENSY2.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_TEENSYLU.h b/Marlin/pins_TEENSYLU.h
index 0538fb95bab206226043db340b5de8c4c8297dc0..ea1492429b4f68feee52f25d46f7f539dd07f780 100644
--- a/Marlin/pins_TEENSYLU.h
+++ b/Marlin/pins_TEENSYLU.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_ULTIMAIN_2.h b/Marlin/pins_ULTIMAIN_2.h
index 62b601ff8d8d3cb3b717f8f18d106d8c2bf60d9d..f4635b3987ab83b7a0a05592004431e1e423f18b 100644
--- a/Marlin/pins_ULTIMAIN_2.h
+++ b/Marlin/pins_ULTIMAIN_2.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_ULTIMAKER.h b/Marlin/pins_ULTIMAKER.h
index 259fca9fc6bf716c5d04037f932c2d2feee49807..36feb6e02148f257f51e1b578f5ad7f9b3dc06c8 100644
--- a/Marlin/pins_ULTIMAKER.h
+++ b/Marlin/pins_ULTIMAKER.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/pins_ULTIMAKER_OLD.h b/Marlin/pins_ULTIMAKER_OLD.h
index 7b7b8d9f89ad825654b9517ace5512a2c99ef88a..d08b5bd271a22e6c183b3ec8db274cf2a8076e57 100644
--- a/Marlin/pins_ULTIMAKER_OLD.h
+++ b/Marlin/pins_ULTIMAKER_OLD.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/planner.cpp b/Marlin/planner.cpp
index b14903c29f3621e43d761f57ef7753f4b4466395..6bc35627a1f00146f1778851118ab0134bd79099 100644
--- a/Marlin/planner.cpp
+++ b/Marlin/planner.cpp
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -1062,7 +1062,7 @@ float junction_deviation = 0.1;
block->advance = advance;
block->advance_rate = acc_dist ? advance / (float)acc_dist : 0;
}
- /*
+ /**
SERIAL_ECHO_START;
SERIAL_ECHOPGM("advance :");
SERIAL_ECHO(block->advance/256.0);
diff --git a/Marlin/planner.h b/Marlin/planner.h
index eca5535542e925877281c94e823314ad64e81094..dd724424b6459820c2340b777bd22db90e6184fd 100644
--- a/Marlin/planner.h
+++ b/Marlin/planner.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,7 +20,7 @@
*
*/
-/*
+/**
planner.h - buffers movement commands and manages the acceleration profile plan
Part of Grbl
diff --git a/Marlin/qr_solve.cpp b/Marlin/qr_solve.cpp
index 202de7ce74170e3d699e260b0d8d01c3e2a66ea3..ddafb005eaddeff95617c02845e2f42e38fc4825 100644
--- a/Marlin/qr_solve.cpp
+++ b/Marlin/qr_solve.cpp
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -32,7 +32,7 @@
int i4_min(int i1, int i2)
/******************************************************************************/
-/*
+/**
Purpose:
I4_MIN returns the smaller of two I4's.
@@ -62,7 +62,7 @@ int i4_min(int i1, int i2)
double r8_epsilon(void)
/******************************************************************************/
-/*
+/**
Purpose:
R8_EPSILON returns the R8 round off unit.
@@ -99,7 +99,7 @@ double r8_epsilon(void)
double r8_max(double x, double y)
/******************************************************************************/
-/*
+/**
Purpose:
R8_MAX returns the maximum of two R8's.
@@ -129,7 +129,7 @@ double r8_max(double x, double y)
double r8_abs(double x)
/******************************************************************************/
-/*
+/**
Purpose:
R8_ABS returns the absolute value of an R8.
@@ -159,7 +159,7 @@ double r8_abs(double x)
double r8_sign(double x)
/******************************************************************************/
-/*
+/**
Purpose:
R8_SIGN returns the sign of an R8.
@@ -189,7 +189,7 @@ double r8_sign(double x)
double r8mat_amax(int m, int n, double a[])
/******************************************************************************/
-/*
+/**
Purpose:
R8MAT_AMAX returns the maximum absolute value entry of an R8MAT.
@@ -234,7 +234,7 @@ double r8mat_amax(int m, int n, double a[])
void r8mat_copy(double a2[], int m, int n, double a1[])
/******************************************************************************/
-/*
+/**
Purpose:
R8MAT_COPY_NEW copies one R8MAT to a "new" R8MAT.
@@ -276,7 +276,7 @@ void r8mat_copy(double a2[], int m, int n, double a1[])
void daxpy(int n, double da, double dx[], int incx, double dy[], int incy)
/******************************************************************************/
-/*
+/**
Purpose:
DAXPY computes constant times a vector plus a vector.
@@ -328,7 +328,7 @@ void daxpy(int n, double da, double dx[], int incx, double dy[], int incy)
if (n <= 0 || da == 0.0) return;
int i, ix, iy, m;
- /*
+ /**
Code for unequal increments or equal increments
not equal to 1.
*/
@@ -347,7 +347,7 @@ void daxpy(int n, double da, double dx[], int incx, double dy[], int incy)
iy = iy + incy;
}
}
- /*
+ /**
Code for both increments equal to 1.
*/
else {
@@ -367,7 +367,7 @@ void daxpy(int n, double da, double dx[], int incx, double dy[], int incy)
double ddot(int n, double dx[], int incx, double dy[], int incy)
/******************************************************************************/
-/*
+/**
Purpose:
DDOT forms the dot product of two vectors.
@@ -422,7 +422,7 @@ double ddot(int n, double dx[], int incx, double dy[], int incy)
int i, m;
double dtemp = 0.0;
- /*
+ /**
Code for unequal increments or equal increments
not equal to 1.
*/
@@ -435,7 +435,7 @@ double ddot(int n, double dx[], int incx, double dy[], int incy)
iy = iy + incy;
}
}
- /*
+ /**
Code for both increments equal to 1.
*/
else {
@@ -457,7 +457,7 @@ double ddot(int n, double dx[], int incx, double dy[], int incy)
double dnrm2(int n, double x[], int incx)
/******************************************************************************/
-/*
+/**
Purpose:
DNRM2 returns the euclidean norm of a vector.
@@ -531,7 +531,7 @@ void dqrank(double a[], int lda, int m, int n, double tol, int* kr,
int jpvt[], double qraux[])
/******************************************************************************/
-/*
+/**
Purpose:
DQRANK computes the QR factorization of a rectangular matrix.
@@ -625,7 +625,7 @@ void dqrdc(double a[], int lda, int n, int p, double qraux[], int jpvt[],
double work[], int job)
/******************************************************************************/
-/*
+/**
Purpose:
DQRDC computes the QR factorization of a real rectangular matrix.
@@ -709,7 +709,7 @@ void dqrdc(double a[], int lda, int n, int p, double qraux[], int jpvt[],
double maxnrm, nrmxl, t, tt;
int pl = 1, pu = 0;
- /*
+ /**
If pivoting is requested, rearrange the columns.
*/
if (job != 0) {
@@ -738,19 +738,19 @@ void dqrdc(double a[], int lda, int n, int p, double qraux[], int jpvt[],
}
}
}
- /*
+ /**
Compute the norms of the free columns.
*/
for (j = pl; j <= pu; j++)
qraux[j - 1] = dnrm2(n, a + 0 + (j - 1) * lda, 1);
for (j = pl; j <= pu; j++)
work[j - 1] = qraux[j - 1];
- /*
+ /**
Perform the Householder reduction of A.
*/
lup = i4_min(n, p);
for (int l = 1; l <= lup; l++) {
- /*
+ /**
Bring the column of largest norm into the pivot position.
*/
if (pl <= l && l < pu) {
@@ -771,7 +771,7 @@ void dqrdc(double a[], int lda, int n, int p, double qraux[], int jpvt[],
jpvt[l - 1] = jp;
}
}
- /*
+ /**
Compute the Householder transformation for column L.
*/
qraux[l - 1] = 0.0;
@@ -782,7 +782,7 @@ void dqrdc(double a[], int lda, int n, int p, double qraux[], int jpvt[],
nrmxl = nrmxl * r8_sign(a[l - 1 + (l - 1) * lda]);
dscal(n - l + 1, 1.0 / nrmxl, a + l - 1 + (l - 1)*lda, 1);
a[l - 1 + (l - 1)*lda] = 1.0 + a[l - 1 + (l - 1) * lda];
- /*
+ /**
Apply the transformation to the remaining columns, updating the norms.
*/
for (j = l + 1; j <= p; j++) {
@@ -804,7 +804,7 @@ void dqrdc(double a[], int lda, int n, int p, double qraux[], int jpvt[],
}
}
}
- /*
+ /**
Save the transformation.
*/
qraux[l - 1] = a[l - 1 + (l - 1) * lda];
@@ -819,7 +819,7 @@ int dqrls(double a[], int lda, int m, int n, double tol, int* kr, double b[],
double x[], double rsd[], int jpvt[], double qraux[], int itask)
/******************************************************************************/
-/*
+/**
Purpose:
DQRLS factors and solves a linear system in the least squares sense.
@@ -949,12 +949,12 @@ int dqrls(double a[], int lda, int m, int n, double tol, int* kr, double b[],
}
ind = 0;
- /*
+ /**
Factor the matrix.
*/
if (itask == 1)
dqrank(a, lda, m, n, tol, kr, jpvt, qraux);
- /*
+ /**
Solve the least-squares problem.
*/
dqrlss(a, lda, m, n, *kr, b, x, rsd, jpvt, qraux);
@@ -966,7 +966,7 @@ void dqrlss(double a[], int lda, int m, int n, int kr, double b[], double x[],
double rsd[], int jpvt[], double qraux[])
/******************************************************************************/
-/*
+/**
Purpose:
DQRLSS solves a linear system in a least squares sense.
@@ -1075,7 +1075,7 @@ int dqrsl(double a[], int lda, int n, int k, double qraux[], double y[],
double qy[], double qty[], double b[], double rsd[], double ab[], int job)
/******************************************************************************/
-/*
+/**
Purpose:
DQRSL computes transformations, projections, and least squares solutions.
@@ -1222,12 +1222,12 @@ int dqrsl(double a[], int lda, int n, int k, double qraux[], double y[],
int ju;
double t;
double temp;
- /*
+ /**
Set INFO flag.
*/
info = 0;
- /*
+ /**
Determine what is to be computed.
*/
cqy = ( job / 10000 != 0);
@@ -1237,7 +1237,7 @@ int dqrsl(double a[], int lda, int n, int k, double qraux[], double y[],
cab = ((job % 10) != 0);
ju = i4_min(k, n - 1);
- /*
+ /**
Special action when N = 1.
*/
if (ju == 0) {
@@ -1257,7 +1257,7 @@ int dqrsl(double a[], int lda, int n, int k, double qraux[], double y[],
rsd[0] = 0.0;
return info;
}
- /*
+ /**
Set up to compute QY or QTY.
*/
if (cqy) {
@@ -1268,7 +1268,7 @@ int dqrsl(double a[], int lda, int n, int k, double qraux[], double y[],
for (i = 1; i <= n; i++)
qty[i - 1] = y[i - 1];
}
- /*
+ /**
Compute QY.
*/
if (cqy) {
@@ -1283,7 +1283,7 @@ int dqrsl(double a[], int lda, int n, int k, double qraux[], double y[],
}
}
}
- /*
+ /**
Compute Q'*Y.
*/
if (cqty) {
@@ -1297,7 +1297,7 @@ int dqrsl(double a[], int lda, int n, int k, double qraux[], double y[],
}
}
}
- /*
+ /**
Set up to compute B, RSD, or AB.
*/
if (cb) {
@@ -1320,7 +1320,7 @@ int dqrsl(double a[], int lda, int n, int k, double qraux[], double y[],
for (i = 1; i <= k; i++)
rsd[i - 1] = 0.0;
}
- /*
+ /**
Compute B.
*/
if (cb) {
@@ -1337,7 +1337,7 @@ int dqrsl(double a[], int lda, int n, int k, double qraux[], double y[],
}
}
}
- /*
+ /**
Compute RSD or AB as required.
*/
if (cr || cab) {
@@ -1369,7 +1369,7 @@ int dqrsl(double a[], int lda, int n, int k, double qraux[], double y[],
void dscal(int n, double sa, double x[], int incx)
/******************************************************************************/
-/*
+/**
Purpose:
DSCAL scales a vector by a constant.
@@ -1444,7 +1444,7 @@ void dscal(int n, double sa, double x[], int incx)
void dswap(int n, double x[], int incx, double y[], int incy)
/******************************************************************************/
-/*
+/**
Purpose:
DSWAP interchanges two vectors.
@@ -1529,7 +1529,7 @@ void dswap(int n, double x[], int incx, double y[], int incy)
void qr_solve(double x[], int m, int n, double a[], double b[])
/******************************************************************************/
-/*
+/**
Purpose:
QR_SOLVE solves a linear system in the least squares sense.
diff --git a/Marlin/qr_solve.h b/Marlin/qr_solve.h
index 7c6733ebf10d515890ba5eae4a38e0d644ee0112..b985d622f271acc1fd116a991dee6890f2f6e9e3 100644
--- a/Marlin/qr_solve.h
+++ b/Marlin/qr_solve.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/servo.cpp b/Marlin/servo.cpp
index 961b39a279e06b84e8edffe6d30f49ec34bdba84..1b8442a0de21dc2fe8b12282f67f532c43a855e7 100644
--- a/Marlin/servo.cpp
+++ b/Marlin/servo.cpp
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,7 +20,7 @@
*
*/
-/*
+/**
servo.cpp - Interrupt driven Servo library for Arduino using 16 bit timers- Version 2
Copyright (c) 2009 Michael Margolis. All right reserved.
@@ -39,7 +39,7 @@
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
*/
-/*
+/**
A servo is activated by creating an instance of the Servo class passing the desired pin to the attach() method.
The servos are pulsed in the background using the value most recently written using the write() method
diff --git a/Marlin/servo.h b/Marlin/servo.h
index 410c0719e71b3a54ef6d0127aad965d90f29f320..13ce9f100119dc70dd9a8c774a276a6ca2c46181 100644
--- a/Marlin/servo.h
+++ b/Marlin/servo.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,7 +20,7 @@
*
*/
-/*
+/**
servo.h - Interrupt driven Servo library for Arduino using 16 bit timers- Version 2
Copyright (c) 2009 Michael Margolis. All right reserved.
@@ -39,7 +39,7 @@
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
*/
-/*
+/**
A servo is activated by creating an instance of the Servo class passing the desired pin to the attach() method.
The servos are pulsed in the background using the value most recently written using the write() method
@@ -71,7 +71,7 @@
#include <inttypes.h>
-/*
+/**
* Defines for 16 bit timers used with Servo library
*
* If _useTimerX is defined then TimerX is a 16 bit timer on the current board
diff --git a/Marlin/speed_lookuptable.h b/Marlin/speed_lookuptable.h
index 1ed4a0b7dade5d7ce28fb6cf2b45cf43f6a4e80f..08cc4839a1bde3da23812f8d93ac3fc45286fcf1 100644
--- a/Marlin/speed_lookuptable.h
+++ b/Marlin/speed_lookuptable.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/stepper.cpp b/Marlin/stepper.cpp
index 9c9c19386c1d5360f50ba2ba4e79c373ed379649..32ae37eedb891640cdd0fa85427f1c0de94ce11d 100644
--- a/Marlin/stepper.cpp
+++ b/Marlin/stepper.cpp
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/stepper.h b/Marlin/stepper.h
index f0c3b2d70548038dbd88566941cdeaac14b214fb..aecbf580293d012a45fa4a0b0cb600d1f5e74d4d 100644
--- a/Marlin/stepper.h
+++ b/Marlin/stepper.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,7 +20,7 @@
*
*/
-/*
+/**
stepper.h - stepper motor driver: executes motion plans of planner.c using the stepper motors
Part of Grbl
diff --git a/Marlin/stepper_dac.cpp b/Marlin/stepper_dac.cpp
index 5830db6e24962ef85340b7ca362900a0a576506a..2e3248daaabad0a1ecec5320e01d138f536cfaca 100644
--- a/Marlin/stepper_dac.cpp
+++ b/Marlin/stepper_dac.cpp
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,7 +20,7 @@
*
*/
-/*
+/**
stepper_dac.cpp - To set stepper current via DAC
Part of Marlin
diff --git a/Marlin/stepper_dac.h b/Marlin/stepper_dac.h
index a9647042673c83efc364e2eda5e688bcf3bfe9c5..d80a8467092c381a06779d5dc1bf8aa0a8b619ea 100644
--- a/Marlin/stepper_dac.h
+++ b/Marlin/stepper_dac.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,7 +20,7 @@
*
*/
-/*
+/**
stepper_dac.h - To set stepper current via DAC
Part of Marlin
diff --git a/Marlin/stepper_indirection.cpp b/Marlin/stepper_indirection.cpp
index e566cd61909727c6df5ca259cbc63cfe3f506198..0ede056143409320f03770f1aba676d4d3608a2a 100644
--- a/Marlin/stepper_indirection.cpp
+++ b/Marlin/stepper_indirection.cpp
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,7 +20,7 @@
*
*/
-/*
+/**
stepper_indirection.c - stepper motor driver indirection
to allow some stepper functions to be done via SPI/I2c instead of direct pin manipulation
Part of Marlin
diff --git a/Marlin/stepper_indirection.h b/Marlin/stepper_indirection.h
index 264cf7efc8d60c16af4998670a2930de2f6e22a0..0a534efdd7b041eacd49f9833d54158e50e9fa16 100644
--- a/Marlin/stepper_indirection.h
+++ b/Marlin/stepper_indirection.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,7 +20,7 @@
*
*/
-/*
+/**
stepper_indirection.h - stepper motor driver indirection macros
to allow some stepper functions to be done via SPI/I2c instead of direct pin manipulation
Part of Marlin
diff --git a/Marlin/temperature.cpp b/Marlin/temperature.cpp
index ab538e25739c59f7a838e8708c219abce99c044d..99909204db312d2fb4c4214ce5f94138da4c316a 100644
--- a/Marlin/temperature.cpp
+++ b/Marlin/temperature.cpp
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,7 +20,7 @@
*
*/
-/*
+/**
temperature.cpp - temperature control
Part of Marlin
@@ -316,7 +316,7 @@ void PID_autotune(float temp, int extruder, int ncycles, bool set_result/*=false
SERIAL_PROTOCOLPGM(MSG_KP); SERIAL_PROTOCOLLN(Kp);
SERIAL_PROTOCOLPGM(MSG_KI); SERIAL_PROTOCOLLN(Ki);
SERIAL_PROTOCOLPGM(MSG_KD); SERIAL_PROTOCOLLN(Kd);
- /*
+ /**
Kp = 0.33*Ku;
Ki = Kp/Tu;
Kd = Kp*Tu/3;
@@ -1118,7 +1118,7 @@ void tp_init() {
static float tr_target_temperature[EXTRUDERS + 1] = { 0.0 };
- /*
+ /**
SERIAL_ECHO_START;
SERIAL_ECHOPGM("Thermal Thermal Runaway Running. Heater ID: ");
if (heater_id < 0) SERIAL_ECHOPGM("bed"); else SERIAL_ECHOPGM(heater_id);
@@ -1435,7 +1435,7 @@ ISR(TIMER0_COMPB_vect) {
#else // SLOW_PWM_HEATERS
- /*
+ /**
* SLOW PWM HEATERS
*
* for heaters drived by relay
diff --git a/Marlin/temperature.h b/Marlin/temperature.h
index 41a611be16aa0c28d583db5b31b68d7b617a6f9e..084b6344dba4a83df99327c048619d258b7034fd 100644
--- a/Marlin/temperature.h
+++ b/Marlin/temperature.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,7 +20,7 @@
*
*/
-/*
+/**
temperature.h - temperature controller
Part of Marlin
diff --git a/Marlin/thermistortables.h b/Marlin/thermistortables.h
index 6e3f83be93bdcebe854403f8a641460e2926a5d9..aeef2c7f7654ef219a47ba1c93d6df74b6aea4a5 100644
--- a/Marlin/thermistortables.h
+++ b/Marlin/thermistortables.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/ultralcd.cpp b/Marlin/ultralcd.cpp
index 96b29e3115c967b74ef3786ea91110d3a239d176..108ce4beaa651f2a4716ea4f2d941bc1c9dc766f 100644
--- a/Marlin/ultralcd.cpp
+++ b/Marlin/ultralcd.cpp
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/ultralcd.h b/Marlin/ultralcd.h
index d725ee18587a2b55b9799449ff0531041843ab75..374310104f3fe2ac73ea6cfdd3f371355bac2098 100644
--- a/Marlin/ultralcd.h
+++ b/Marlin/ultralcd.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/ultralcd_implementation_hitachi_HD44780.h b/Marlin/ultralcd_implementation_hitachi_HD44780.h
index 8613918f9e5c866fe251745648e847652b304f25..c5c8bd04d4165ed2544fa56073eda12507a37d11 100644
--- a/Marlin/ultralcd_implementation_hitachi_HD44780.h
+++ b/Marlin/ultralcd_implementation_hitachi_HD44780.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -533,7 +533,7 @@ unsigned lcd_print(char c) { return charset_mapper(c); }
#endif // SHOW_BOOTSCREEN
-/*
+/**
Possible status screens:
16x2 |000/000 B000/000|
|0123456789012345|
diff --git a/Marlin/ultralcd_st7920_u8glib_rrd.h b/Marlin/ultralcd_st7920_u8glib_rrd.h
index 261a5b91a8d2a9d1364ff58e5e968f0c83c41fd4..9aa53ceabab2df9aefe733acbf996e3e54d85162 100644
--- a/Marlin/ultralcd_st7920_u8glib_rrd.h
+++ b/Marlin/ultralcd_st7920_u8glib_rrd.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/utf_mapper.h b/Marlin/utf_mapper.h
index 782a36b92c1bbb82c90acdd48f75f4eb1dc41a94..26e97772bfaf424a10b2b36ffd967e53478cd44b 100644
--- a/Marlin/utf_mapper.h
+++ b/Marlin/utf_mapper.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/vector_3.cpp b/Marlin/vector_3.cpp
index 2bc2e90685c8c6716c792cdaa240079451f7a267..1cca0d9d8d93722d0b39c6a7ecd3673de095944d 100644
--- a/Marlin/vector_3.cpp
+++ b/Marlin/vector_3.cpp
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,7 +20,7 @@
*
*/
-/*
+/**
vector_3.cpp - Vector library for bed leveling
Copyright (c) 2012 Lars Brubaker. All right reserved.
diff --git a/Marlin/vector_3.h b/Marlin/vector_3.h
index 6a40513f89899447e039badcd619e3c8098bff01..e76188b04b8c31097433194b6e91abfec63fff8a 100644
--- a/Marlin/vector_3.h
+++ b/Marlin/vector_3.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
@@ -20,7 +20,7 @@
*
*/
-/*
+/**
vector_3.cpp - Vector library for bed leveling
Copyright (c) 2012 Lars Brubaker. All right reserved.
diff --git a/Marlin/watchdog.cpp b/Marlin/watchdog.cpp
index f8de418073552ff8bfd733a265d172a25ad3aff2..4397ab603d93886f03dd2bf700f05ce1b63eb97f 100644
--- a/Marlin/watchdog.cpp
+++ b/Marlin/watchdog.cpp
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*
diff --git a/Marlin/watchdog.h b/Marlin/watchdog.h
index 77e17fa7aabfca30555d81a56c3e90d4213375e5..2c04b58972d365f85ecf637874250802cc4460f7 100644
--- a/Marlin/watchdog.h
+++ b/Marlin/watchdog.h
@@ -1,4 +1,4 @@
-/*
+/**
* Marlin 3D Printer Firmware
* Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
*