Check-in [f29effaf2b]

Many hyperlinks are disabled.
Use anonymous login to enable hyperlinks.

Overview
Comment:Deprecate the old TODO stuff and instead have future things use the debugging class.
Downloads: Tarball | ZIP archive | SQL archive
Timelines: family | ancestors | descendants | both | wip-springcoat-bringup
Files: files | file ages | folders
SHA1: f29effaf2b0dff0330d4f42ab1540d7d1b493036
User & Date: stephanie.gawroriski 2020-03-22 22:28:27
Context
2020-03-22
22:51
Deprecate some SpringCoat thread worker methods. check-in: a8c75ba0fc user: stephanie.gawroriski tags: wip-springcoat-bringup
22:28
Deprecate the old TODO stuff and instead have future things use the debugging class. check-in: f29effaf2b user: stephanie.gawroriski tags: wip-springcoat-bringup
22:26
Add oops to debugging. check-in: 84e5610b18 user: stephanie.gawroriski tags: wip-springcoat-bringup
Changes
Hide Diffs Unified Diffs Ignore Whitespace Patch

Changes to modules/cldc-compact/src/main/java/cc/squirreljme/runtime/cldc/debug/Debugging.java.

31
32
33
34
35
36
37

38
39
40
41
42
43
44
45
46
47
48
49

50
51
52
53
54
55
56
57
58
59
60
61

62
63
64
65
66
	/**
	 * Emits an oops error.
	 *
	 * @param __args Argument to the error.
	 * @return The generated error.
	 * @since 2020/03/22
	 */

	public static OOPS oops(Object... __args)
	{
		return OOPS.OOPS(__args);
	}
	
	/**
	 * Emits a To-Do error.
	 *
	 * @param __args Arguments to the error.
	 * @return The generated error.
	 * @since 2020/03/21
	 */

	public static TODO todo(Object... __args)
	{
		return TODO.TODO(__args);
	}
	
	/**
	 * Emits a To-Do note.
	 *
	 * @param __fmt Format string.
	 * @param __args Arguments.
	 * @since 2020/03/31
	 */

	public static void todoNote(String __fmt, Object... __args)
	{
		TODO.note(__fmt, __args);
	}
}







>
|











>
|











>





31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
	/**
	 * Emits an oops error.
	 *
	 * @param __args Argument to the error.
	 * @return The generated error.
	 * @since 2020/03/22
	 */
	@SuppressWarnings("deprecation")
	public static Error oops(Object... __args)
	{
		return OOPS.OOPS(__args);
	}
	
	/**
	 * Emits a To-Do error.
	 *
	 * @param __args Arguments to the error.
	 * @return The generated error.
	 * @since 2020/03/21
	 */
	@SuppressWarnings("deprecation")
	public static Error todo(Object... __args)
	{
		return TODO.TODO(__args);
	}
	
	/**
	 * Emits a To-Do note.
	 *
	 * @param __fmt Format string.
	 * @param __args Arguments.
	 * @since 2020/03/31
	 */
	@SuppressWarnings("deprecation")
	public static void todoNote(String __fmt, Object... __args)
	{
		TODO.note(__fmt, __args);
	}
}

Changes to modules/cldc-compact/src/main/java/todo/OOPS.java.

18
19
20
21
22
23
24

25
26
27
28
29
30
31
..
54
55
56
57
58
59
60

61
62
63
64
65
66
67
..
68
69
70
71
72
73
74

75
76
77
78
79
80
81
..
83
84
85
86
87
88
89

90
91
92
93
94
95
96

/**
 * This is an error which is thrown when a condition which should not occur
 * occurs.
 *
 * @since 2018/11/25
 */

public class OOPS
	extends CodeProgressError
{
	/**
	 * Initializes the oops exception.
	 *
	 * @since 2020/03/15
................................................................................
	/**
	 * Constructor which does not call the static handler.
	 *
	 * @param __ignore Not used.
	 * @param __m The message.
	 * @since 2020/03/15
	 */

	OOPS(@SuppressWarnings("unused") boolean __ignore, String __m)
	{
		super(__m);
	}
	
	/**
	 * Handles the OOPS logic and returns OOPS exception.
................................................................................
	 *
	 * @param __args The arguments to the OOPS.
	 * @return The resultant exception.
	 * @since 2020/03/15
	 */
	@SuppressWarnings({"NewMethodNamingConvention",
		"MethodNameSameAsClassName"})

	public static OOPS OOPS(Object... __args)
	{
		return OOPS.__oops(false, CallTraceElement.traceRaw(),
			__args);
	}
	
	/**
................................................................................
	 *
	 * @param __fromInit From initializer?
	 * @param __trace The trace.
	 * @param __args The arguments to the OOPS.
	 * @return The resultant exception.
	 * @since 2020/03/15
	 */

	static OOPS __oops(boolean __fromInit, int[] __trace, Object... __args)
	{
		// Perform printing logic for this trace
		__Utilities__.dumpTrace('O', 'P', __trace, __args);
			
		// Exit on oops?
		if ((Assembly.sysCallPV(SystemCallIndex.DEBUG_FLAGS) &







>







 







>







 







>







 







>







18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
..
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
..
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
..
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100

/**
 * This is an error which is thrown when a condition which should not occur
 * occurs.
 *
 * @since 2018/11/25
 */
@Deprecated
public class OOPS
	extends CodeProgressError
{
	/**
	 * Initializes the oops exception.
	 *
	 * @since 2020/03/15
................................................................................
	/**
	 * Constructor which does not call the static handler.
	 *
	 * @param __ignore Not used.
	 * @param __m The message.
	 * @since 2020/03/15
	 */
	@Deprecated
	OOPS(@SuppressWarnings("unused") boolean __ignore, String __m)
	{
		super(__m);
	}
	
	/**
	 * Handles the OOPS logic and returns OOPS exception.
................................................................................
	 *
	 * @param __args The arguments to the OOPS.
	 * @return The resultant exception.
	 * @since 2020/03/15
	 */
	@SuppressWarnings({"NewMethodNamingConvention",
		"MethodNameSameAsClassName"})
	@Deprecated
	public static OOPS OOPS(Object... __args)
	{
		return OOPS.__oops(false, CallTraceElement.traceRaw(),
			__args);
	}
	
	/**
................................................................................
	 *
	 * @param __fromInit From initializer?
	 * @param __trace The trace.
	 * @param __args The arguments to the OOPS.
	 * @return The resultant exception.
	 * @since 2020/03/15
	 */
	@Deprecated
	static OOPS __oops(boolean __fromInit, int[] __trace, Object... __args)
	{
		// Perform printing logic for this trace
		__Utilities__.dumpTrace('O', 'P', __trace, __args);
			
		// Exit on oops?
		if ((Assembly.sysCallPV(SystemCallIndex.DEBUG_FLAGS) &

Changes to modules/cldc-compact/src/main/java/todo/TODO.java.

19
20
21
22
23
24
25

26
27
28
29
30
31
32
..
55
56
57
58
59
60
61

62
63
64
65
66
67
68
69
70
71
72

73
74
75
76
77
78
79
..
80
81
82
83
84
85
86

87
88
89
90
91
92
93
..
94
95
96
97
98
99
100

101
102
103
104
105
106
107
108
109
110
111
112

113
114
115
116
117
118
119
...
123
124
125
126
127
128
129

130
131
132
133
134
135
136
/**
 * This exception is thrown.
 *
 * When constructed, this exception does not normall finish execution.
 *
 * @since 2017/02/28
 */

public class TODO
	extends CodeProgressError
{
	/**
	 * Initializes the exception, prints the trace, and exits the program.
	 *
	 * @since 2017/02/28
................................................................................
	/**
	 * Constructor which does not call the static handler.
	 *
	 * @param __ignore Not used.
	 * @param __m The message.
	 * @since 2020/03/15
	 */

	TODO(@SuppressWarnings("unused") boolean __ignore, String __m)
	{
		super(__m);
	}
	
	/**
	 * Specifies that the integer value is missing.
	 *
	 * @return An integer, but is not returned from.
	 * @since 2017/10/27
	 */

	@SuppressWarnings("ThrowableNotThrown")
	public static int missingInteger()
	{
		TODO.__todo(false, CallTraceElement.traceRaw());
		return 0;
	}
	
................................................................................
	/**
	 * Specifies that the object value is missing.
	 *
	 * @param <T> The object to miss.
	 * @return Should return that object, but never does.
	 * @since 2017/10/24
	 */

	@SuppressWarnings("ThrowableNotThrown")
	public static <T> T missingObject()
	{
		TODO.__todo(false, CallTraceElement.traceRaw());
		return null;
	}
	
................................................................................
	/**
	 * Prints a note to standard error about something that is incomplete.
	 *
	 * @param __fmt The format string.
	 * @param __args The arguments to the call.
	 * @since 2018/04/02
	 */

	public static void note(String __fmt, Object... __args)
	{
		__Utilities__.dumpFormatLine('T', 'O', __fmt, __args);
	}
	
	/**
	 * Handles the To-Do logic and returns To-Do exception.
	 *
	 * @param __args The arguments to the To-Do.
	 * @return The resultant exception.
	 * @since 2020/03/15
	 */

	@SuppressWarnings({"NewMethodNamingConvention",
		"MethodNameSameAsClassName"})
	public static TODO TODO(Object... __args)
	{
		return TODO.__todo(false, CallTraceElement.traceRaw(),
			__args);
	}
................................................................................
	 *
	 * @param __fromInit From initializer?
	 * @param __trace The stack trace.
	 * @param __args The arguments to the To-Do.
	 * @return The resultant exception.
	 * @since 2020/03/15
	 */

	static TODO __todo(boolean __fromInit, int[] __trace, Object... __args)
	{
		// Perform printing logic for this trace
		__Utilities__.dumpTrace('T', 'D', __trace, __args);
			
		// Exit on to-do?
		if ((Assembly.sysCallPV(SystemCallIndex.DEBUG_FLAGS) &







>







 







>











>







 







>







 







>












>







 







>







19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
..
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
..
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
..
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
...
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
/**
 * This exception is thrown.
 *
 * When constructed, this exception does not normall finish execution.
 *
 * @since 2017/02/28
 */
@Deprecated
public class TODO
	extends CodeProgressError
{
	/**
	 * Initializes the exception, prints the trace, and exits the program.
	 *
	 * @since 2017/02/28
................................................................................
	/**
	 * Constructor which does not call the static handler.
	 *
	 * @param __ignore Not used.
	 * @param __m The message.
	 * @since 2020/03/15
	 */
	@Deprecated
	TODO(@SuppressWarnings("unused") boolean __ignore, String __m)
	{
		super(__m);
	}
	
	/**
	 * Specifies that the integer value is missing.
	 *
	 * @return An integer, but is not returned from.
	 * @since 2017/10/27
	 */
	@Deprecated
	@SuppressWarnings("ThrowableNotThrown")
	public static int missingInteger()
	{
		TODO.__todo(false, CallTraceElement.traceRaw());
		return 0;
	}
	
................................................................................
	/**
	 * Specifies that the object value is missing.
	 *
	 * @param <T> The object to miss.
	 * @return Should return that object, but never does.
	 * @since 2017/10/24
	 */
	@Deprecated
	@SuppressWarnings("ThrowableNotThrown")
	public static <T> T missingObject()
	{
		TODO.__todo(false, CallTraceElement.traceRaw());
		return null;
	}
	
................................................................................
	/**
	 * Prints a note to standard error about something that is incomplete.
	 *
	 * @param __fmt The format string.
	 * @param __args The arguments to the call.
	 * @since 2018/04/02
	 */
	@Deprecated
	public static void note(String __fmt, Object... __args)
	{
		__Utilities__.dumpFormatLine('T', 'O', __fmt, __args);
	}
	
	/**
	 * Handles the To-Do logic and returns To-Do exception.
	 *
	 * @param __args The arguments to the To-Do.
	 * @return The resultant exception.
	 * @since 2020/03/15
	 */
	@Deprecated
	@SuppressWarnings({"NewMethodNamingConvention",
		"MethodNameSameAsClassName"})
	public static TODO TODO(Object... __args)
	{
		return TODO.__todo(false, CallTraceElement.traceRaw(),
			__args);
	}
................................................................................
	 *
	 * @param __fromInit From initializer?
	 * @param __trace The stack trace.
	 * @param __args The arguments to the To-Do.
	 * @return The resultant exception.
	 * @since 2020/03/15
	 */
	@Deprecated
	static TODO __todo(boolean __fromInit, int[] __trace, Object... __args)
	{
		// Perform printing logic for this trace
		__Utilities__.dumpTrace('T', 'D', __trace, __args);
			
		// Exit on to-do?
		if ((Assembly.sysCallPV(SystemCallIndex.DEBUG_FLAGS) &