From 8b06c524d207f5e67ef22d6a1869c94d8f91717f Mon Sep 17 00:00:00 2001 From: Campbell Barton Date: Fri, 4 Mar 2022 10:29:53 +1100 Subject: [PATCH] Cleanup: spelling in comments, function name --- intern/cycles/integrator/path_trace.cpp | 2 +- .../draw/engines/gpencil/gpencil_render.c | 2 +- .../draw/engines/image/image_drawing_mode.hh | 2 +- .../blender/editors/gpencil/annotate_draw.c | 8 +++++-- .../blender/editors/gpencil/annotate_paint.c | 6 ++--- .../blender/editors/gpencil/gpencil_paint.c | 6 ++--- source/blender/editors/include/ED_numinput.h | 10 ++++---- .../editors/interface/interface_handlers.c | 4 ++-- source/blender/editors/mesh/editmesh_select.c | 2 +- source/blender/editors/object/object_bake.c | 2 +- .../blender/editors/object/object_bake_api.c | 2 +- .../blender/editors/render/render_internal.cc | 2 +- .../blender/editors/render/render_preview.cc | 4 ++-- .../blender/editors/render/render_shading.cc | 2 +- .../editors/space_image/image_sequence.c | 5 ++-- .../transform/transform_mode_timescale.c | 4 ++-- .../transform/transform_mode_timeslide.c | 6 ++--- .../transform/transform_mode_timetranslate.c | 6 ++--- source/blender/editors/util/ed_draw.c | 2 +- source/blender/editors/uvedit/uvedit_ops.c | 4 ++-- source/blender/makesdna/DNA_screen_types.h | 6 ++--- source/blender/makesdna/DNA_space_types.h | 7 +++--- .../makesdna/DNA_windowmanager_types.h | 23 +++++++++++-------- source/blender/windowmanager/intern/wm.c | 4 ++-- .../windowmanager/intern/wm_init_exit.c | 6 ++--- .../blender/windowmanager/intern/wm_window.c | 4 ++-- 26 files changed, 69 insertions(+), 62 deletions(-) diff --git a/intern/cycles/integrator/path_trace.cpp b/intern/cycles/integrator/path_trace.cpp index eb12b0a6a11..ab134179602 100644 --- a/intern/cycles/integrator/path_trace.cpp +++ b/intern/cycles/integrator/path_trace.cpp @@ -466,7 +466,7 @@ void PathTrace::set_denoiser_params(const DenoiseParams ¶ms) denoiser_ = Denoiser::create(device_, params); /* Only take into account the "immediate" cancel to have interactive rendering responding to - * navigation as quickly as possible, but allow to run denoiser after user hit Esc button while + * navigation as quickly as possible, but allow to run denoiser after user hit Escape key while * doing offline rendering. */ denoiser_->is_cancelled_cb = [this]() { return render_cancel_.is_requested; }; } diff --git a/source/blender/draw/engines/gpencil/gpencil_render.c b/source/blender/draw/engines/gpencil/gpencil_render.c index 9c3779c18ad..19afdb3de5a 100644 --- a/source/blender/draw/engines/gpencil/gpencil_render.c +++ b/source/blender/draw/engines/gpencil/gpencil_render.c @@ -174,7 +174,7 @@ static void GPENCIL_render_result_z(struct RenderLayer *rl, int pix_ct = BLI_rcti_size_x(rect) * BLI_rcti_size_y(rect); - /* Convert ogl depth [0..1] to view Z [near..far] */ + /* Convert GPU depth [0..1] to view Z [near..far] */ if (DRW_view_is_persp_get(NULL)) { for (int i = 0; i < pix_ct; i++) { if (rp->rect[i] == 1.0f) { diff --git a/source/blender/draw/engines/image/image_drawing_mode.hh b/source/blender/draw/engines/image/image_drawing_mode.hh index c091f800d95..46482ab6668 100644 --- a/source/blender/draw/engines/image/image_drawing_mode.hh +++ b/source/blender/draw/engines/image/image_drawing_mode.hh @@ -401,7 +401,7 @@ template class ScreenSpaceDrawingMode : public AbstractD /** * \brief Ensure that the float buffer of the given image buffer is available. * - * Returns true when a float buffer was created. Somehow the VSE cache increases the ref + * Returns true when a float buffer was created. Somehow the sequencer cache increases the ref * counter, but might use a different mechanism for destructing the image, that doesn't free the * rect_float as the reference-counter isn't 0. To work around this we destruct any created local * buffers ourself. diff --git a/source/blender/editors/gpencil/annotate_draw.c b/source/blender/editors/gpencil/annotate_draw.c index f175145fca7..f720f261ad5 100644 --- a/source/blender/editors/gpencil/annotate_draw.c +++ b/source/blender/editors/gpencil/annotate_draw.c @@ -110,7 +110,9 @@ static void annotation_draw_stroke_arrow_buffer(uint pos, immEnd(); } -/* draw stroke defined in buffer (simple ogl lines/points for now, as dotted lines) */ +/** + * Draw stroke defined in buffer (simple GPU lines/points for now, as dotted lines). + */ static void annotation_draw_stroke_buffer(bGPdata *gps, short thickness, short dflag, @@ -298,7 +300,9 @@ static void annotation_draw_stroke_point(const bGPDspoint *points, immUnbindProgram(); } -/* draw a given stroke in 3d (i.e. in 3d-space), using simple ogl lines */ +/** + * Draw a given stroke in 3d (i.e. in 3d-space), using simple GPU lines. + */ static void annotation_draw_stroke_3d( const bGPDspoint *points, int totpoints, short thickness, const float ink[4], bool cyclic) { diff --git a/source/blender/editors/gpencil/annotate_paint.c b/source/blender/editors/gpencil/annotate_paint.c index 5ab4a663efe..1a7b034f2f8 100644 --- a/source/blender/editors/gpencil/annotate_paint.c +++ b/source/blender/editors/gpencil/annotate_paint.c @@ -2466,10 +2466,10 @@ static int annotation_draw_modal(bContext *C, wmOperator *op, const wmEvent *eve EVT_PAD7, EVT_PAD8, EVT_PAD9)) { - /* allow numpad keys so that camera/view manipulations can still take place - * - PAD0 in particular is really important for Grease Pencil drawing, + /* Allow numpad keys so that camera/view manipulations can still take place + * - #EVT_PAD0 in particular is really important for Grease Pencil drawing, * as animators may be working "to camera", so having this working - * is essential for ensuring that they can quickly return to that view + * is essential for ensuring that they can quickly return to that view. */ } else if ((event->type == EVT_BKEY) && (event->val == KM_RELEASE)) { diff --git a/source/blender/editors/gpencil/gpencil_paint.c b/source/blender/editors/gpencil/gpencil_paint.c index 4862545e917..22bdc1af119 100644 --- a/source/blender/editors/gpencil/gpencil_paint.c +++ b/source/blender/editors/gpencil/gpencil_paint.c @@ -3649,10 +3649,10 @@ static int gpencil_draw_modal(bContext *C, wmOperator *op, const wmEvent *event) EVT_PAD7, EVT_PAD8, EVT_PAD9)) { - /* allow numpad keys so that camera/view manipulations can still take place - * - PAD0 in particular is really important for Grease Pencil drawing, + /* Allow numpad keys so that camera/view manipulations can still take place + * - #EVT_PAD0 in particular is really important for Grease Pencil drawing, * as animators may be working "to camera", so having this working - * is essential for ensuring that they can quickly return to that view + * is essential for ensuring that they can quickly return to that view. */ } else if ((!ELEM(p->paintmode, GP_PAINTMODE_ERASER, GP_PAINTMODE_SET_CP))) { diff --git a/source/blender/editors/include/ED_numinput.h b/source/blender/editors/include/ED_numinput.h index 77c3794b6fc..12e3ffee627 100644 --- a/source/blender/editors/include/ED_numinput.h +++ b/source/blender/editors/include/ED_numinput.h @@ -66,14 +66,14 @@ struct UnitSettings; * \{ */ /** - * There are important things to note here for code using numinput: + * There are important things to note here for code using numeric-input: * - Values passed to #applyNumInput() should be valid and are stored as default ones (val_org), * if it is not EDITED. - * - bool returned by #applyNumInput should be used to decide whether to apply - * numinput-specific post-process to data. + * - `bool` returned by #applyNumInput should be used to decide whether to apply + * numeric-input-specific post-process to data. * - Once #applyNumInput has been called, - * #hasNumInput returns a valid value to decide whether to use numinput as drawstr source or not - * (i.e. to call #outputNumInput). + * #hasNumInput returns a valid value to decide whether to use numinput as `drawstr` + * source or not (i.e. to call #outputNumInput). * * Those two steps have to be separated * (so do not use a common call to #hasNumInput() to do both in the same time!). diff --git a/source/blender/editors/interface/interface_handlers.c b/source/blender/editors/interface/interface_handlers.c index 80fef93faf8..dbb2ea1dd42 100644 --- a/source/blender/editors/interface/interface_handlers.c +++ b/source/blender/editors/interface/interface_handlers.c @@ -3903,8 +3903,8 @@ static void ui_do_but_textedit( char ascii = event->ascii; const char *utf8_buf = event->utf8_buf; - /* exception that's useful for number buttons, some keyboard - * numpads have a comma instead of a period */ + /* Exception that's useful for number buttons, some keyboard + * numpads have a comma instead of a period. */ if (ELEM(but->type, UI_BTYPE_NUM, UI_BTYPE_NUM_SLIDER)) { /* Could use `data->min`. */ if (event->type == EVT_PADPERIOD && ascii == ',') { ascii = '.'; diff --git a/source/blender/editors/mesh/editmesh_select.c b/source/blender/editors/mesh/editmesh_select.c index d8fc7a4f9d4..8784b1a90d9 100644 --- a/source/blender/editors/mesh/editmesh_select.c +++ b/source/blender/editors/mesh/editmesh_select.c @@ -3552,7 +3552,7 @@ static int edbm_select_linked_pick_invoke(bContext *C, wmOperator *op, const wmE return edbm_select_linked_pick_exec(C, op); } - /* unified_finednearest needs ogl */ + /* #unified_findnearest needs OpenGL. */ view3d_operator_needs_opengl(C); /* setup view context for argument to callbacks */ diff --git a/source/blender/editors/object/object_bake.c b/source/blender/editors/object/object_bake.c index 8f5aa919ec0..dbb6916dfce 100644 --- a/source/blender/editors/object/object_bake.c +++ b/source/blender/editors/object/object_bake.c @@ -571,7 +571,7 @@ static int multiresbake_image_exec(bContext *C, wmOperator *op) /* ****************** render BAKING ********************** */ -/* catch esc */ +/** Catch escape key to cancel. */ static int objects_bake_render_modal(bContext *C, wmOperator *UNUSED(op), const wmEvent *event) { /* no running blender, remove handler and pass through */ diff --git a/source/blender/editors/object/object_bake_api.c b/source/blender/editors/object/object_bake_api.c index 3b40a10eb2a..3529574a3a4 100644 --- a/source/blender/editors/object/object_bake_api.c +++ b/source/blender/editors/object/object_bake_api.c @@ -123,7 +123,7 @@ static void bake_progress_update(void *bjv, float progress) } } -/* catch esc */ +/** Catch escape key to cancel. */ static int bake_modal(bContext *C, wmOperator *UNUSED(op), const wmEvent *event) { /* no running blender, remove handler and pass through */ diff --git a/source/blender/editors/render/render_internal.cc b/source/blender/editors/render/render_internal.cc index 03c0f3977b7..33b68dfb47b 100644 --- a/source/blender/editors/render/render_internal.cc +++ b/source/blender/editors/render/render_internal.cc @@ -818,7 +818,7 @@ static void render_drawlock(void *rjv, bool lock) } } -/* catch esc */ +/** Catch escape key to cancel. */ static int screen_render_modal(bContext *C, wmOperator *op, const wmEvent *event) { Scene *scene = (Scene *)op->customdata; diff --git a/source/blender/editors/render/render_preview.cc b/source/blender/editors/render/render_preview.cc index eca30a6ac25..cfb88cd7868 100644 --- a/source/blender/editors/render/render_preview.cc +++ b/source/blender/editors/render/render_preview.cc @@ -259,7 +259,7 @@ static bool render_engine_supports_ray_visibility(const Scene *sce) return !STREQ(sce->r.engine, RE_engine_id_BLENDER_EEVEE); } -static void switch_preview_collection_visibilty(ViewLayer *view_layer, const ePreviewType pr_type) +static void switch_preview_collection_visibility(ViewLayer *view_layer, const ePreviewType pr_type) { /* Set appropriate layer as visible. */ LayerCollection *lc = static_cast(view_layer->layer_collections.first); @@ -329,7 +329,7 @@ static void set_preview_visibility(Main *pr_main, const ePreviewType pr_type, const ePreviewRenderMethod pr_method) { - switch_preview_collection_visibilty(view_layer, pr_type); + switch_preview_collection_visibility(view_layer, pr_type); switch_preview_floor_visibility(pr_main, scene, view_layer, pr_method); BKE_layer_collection_sync(scene, view_layer); } diff --git a/source/blender/editors/render/render_shading.cc b/source/blender/editors/render/render_shading.cc index cd395674177..5e0927eb0cb 100644 --- a/source/blender/editors/render/render_shading.cc +++ b/source/blender/editors/render/render_shading.cc @@ -1141,7 +1141,7 @@ static void light_cache_bake_tag_cache(Scene *scene, wmOperator *op) } } -/* catch esc */ +/** Catch escape key to cancel. */ static int light_cache_bake_modal(bContext *C, wmOperator *op, const wmEvent *event) { Scene *scene = (Scene *)op->customdata; diff --git a/source/blender/editors/space_image/image_sequence.c b/source/blender/editors/space_image/image_sequence.c index abe2a359a69..365cf2542b2 100644 --- a/source/blender/editors/space_image/image_sequence.c +++ b/source/blender/editors/space_image/image_sequence.c @@ -33,9 +33,8 @@ typedef struct ImageFrame { } ImageFrame; /** - * Get a list of frames from the list of image files matching the first file - * name sequence pattern. The files and directory are read from standard - * fileselect operator properties. + * Get a list of frames from the list of image files matching the first file name sequence pattern. + * The files and directory are read from standard file-select operator properties. * * The output is a list of frame ranges, each containing a list of frames with matching names. */ diff --git a/source/blender/editors/transform/transform_mode_timescale.c b/source/blender/editors/transform/transform_mode_timescale.c index a4f46803143..4130f6dc034 100644 --- a/source/blender/editors/transform/transform_mode_timescale.c +++ b/source/blender/editors/transform/transform_mode_timescale.c @@ -123,12 +123,12 @@ void initTimeScale(TransInfo *t) t->flag |= T_NULL_ONE; t->num.val_flag[0] |= NUM_NULL_ONE; - /* num-input has max of (n-1) */ + /* Numeric-input has max of (n-1). */ t->idx_max = 0; t->num.flag = 0; t->num.idx_max = t->idx_max; - /* initialize snap like for everything else */ + /* Initialize snap like for everything else. */ t->snap[0] = t->snap[1] = 1.0f; copy_v3_fl(t->num.val_inc, t->snap[0]); diff --git a/source/blender/editors/transform/transform_mode_timeslide.c b/source/blender/editors/transform/transform_mode_timeslide.c index 4d40c427ef7..d442c12574b 100644 --- a/source/blender/editors/transform/transform_mode_timeslide.c +++ b/source/blender/editors/transform/transform_mode_timeslide.c @@ -203,17 +203,17 @@ void initTimeSlide(TransInfo *t) range[1] = max; } - /* num-input has max of (n-1) */ + /* Numeric-input has max of (n-1). */ t->idx_max = 0; t->num.flag = 0; t->num.idx_max = t->idx_max; - /* initialize snap like for everything else */ + /* Initialize snap like for everything else. */ t->snap[0] = t->snap[1] = 1.0f; copy_v3_fl(t->num.val_inc, t->snap[0]); t->num.unit_sys = t->scene->unit.system; - /* No time unit supporting frames currently... */ + /* No time unit supporting frames currently. */ t->num.unit_type[0] = B_UNIT_NONE; } diff --git a/source/blender/editors/transform/transform_mode_timetranslate.c b/source/blender/editors/transform/transform_mode_timetranslate.c index ea002129d0c..801d79e3fc7 100644 --- a/source/blender/editors/transform/transform_mode_timetranslate.c +++ b/source/blender/editors/transform/transform_mode_timetranslate.c @@ -129,17 +129,17 @@ void initTimeTranslate(TransInfo *t) initMouseInputMode(t, &t->mouse, INPUT_NONE); - /* num-input has max of (n-1) */ + /* Numeric-input has max of (n-1). */ t->idx_max = 0; t->num.flag = 0; t->num.idx_max = t->idx_max; - /* initialize snap like for everything else */ + /* Initialize snap like for everything else. */ t->snap[0] = t->snap[1] = 1.0f; copy_v3_fl(t->num.val_inc, t->snap[0]); t->num.unit_sys = t->scene->unit.system; - /* No time unit supporting frames currently... */ + /* No time unit supporting frames currently. */ t->num.unit_type[0] = B_UNIT_NONE; } diff --git a/source/blender/editors/util/ed_draw.c b/source/blender/editors/util/ed_draw.c index acf7fd713fa..eaa1684930d 100644 --- a/source/blender/editors/util/ed_draw.c +++ b/source/blender/editors/util/ed_draw.c @@ -760,7 +760,7 @@ void ED_region_image_metadata_draw( /* find window pixel coordinates of origin */ GPU_matrix_push(); - /* offset and zoom using ogl */ + /* Offset and zoom using GPU viewport. */ GPU_matrix_translate_2f(x, y); GPU_matrix_scale_2f(zoomx, zoomy); diff --git a/source/blender/editors/uvedit/uvedit_ops.c b/source/blender/editors/uvedit/uvedit_ops.c index cbf0522c328..bbf84ee74d7 100644 --- a/source/blender/editors/uvedit/uvedit_ops.c +++ b/source/blender/editors/uvedit/uvedit_ops.c @@ -1625,7 +1625,7 @@ static int uv_reveal_exec(bContext *C, wmOperator *op) /* NOTE: Selecting faces is delayed so that it doesn't select verts/edges and confuse certain * UV selection checks. * This creates a temporary state which breaks certain UV selection functions that do face - * visibilty checks internally. Current implementation handles each case separately. */ + * visibility checks internally. Current implementation handles each case separately. */ /* call the mesh function if we are in mesh sync sel */ if (ts->uv_flag & UV_SYNC_SELECTION) { @@ -1641,7 +1641,7 @@ static int uv_reveal_exec(bContext *C, wmOperator *op) } /* NOTE(@sidd017): Supporting selections in all cases is quite difficult considering there are - * at least 12 cases to look into (3 mesh selectmodes + 4 uv selectmodes + sticky modes). + * at least 12 cases to look into (3 mesh select-modes + 4 uv select-modes + sticky modes). * For now we select all UV faces as sticky disabled to ensure proper UV selection states (vert * + edge flags) */ if (use_face_center) { diff --git a/source/blender/makesdna/DNA_screen_types.h b/source/blender/makesdna/DNA_screen_types.h index d48149b2fa6..c8209b4d194 100644 --- a/source/blender/makesdna/DNA_screen_types.h +++ b/source/blender/makesdna/DNA_screen_types.h @@ -56,12 +56,12 @@ typedef struct bScreen { short flag; /** Winid from WM, starts with 1. */ short winid; - /** User-setting for which editors get redrawn during anim playback. */ + /** User-setting for which editors get redrawn during animation playback. */ short redraws_flag; - /** Temp screen in a temp window, don't save (like user prefs). */ + /** Temp screen in a temp window, don't save (like user-preferences). */ char temp; - /** Temp screen for image render display or fileselect. */ + /** Temp screen for image render display or file-select. */ char state; /** Notifier for drawing edges. */ char do_draw; diff --git a/source/blender/makesdna/DNA_space_types.h b/source/blender/makesdna/DNA_space_types.h index b1212965992..e6c163d94ba 100644 --- a/source/blender/makesdna/DNA_space_types.h +++ b/source/blender/makesdna/DNA_space_types.h @@ -894,10 +894,9 @@ typedef struct SpaceFile { */ ListBase folder_histories; /* FileFolderHistory */ - /* operator that is invoking fileselect - * op->exec() will be called on the 'Load' button. - * if operator provides op->cancel(), then this will be invoked - * on the cancel button. + /** + * The operator that is invoking file-select `op->exec()` will be called on the 'Load' button. + * if operator provides op->cancel(), then this will be invoked on the cancel button. */ struct wmOperator *op; diff --git a/source/blender/makesdna/DNA_windowmanager_types.h b/source/blender/makesdna/DNA_windowmanager_types.h index 7a972ac3ef8..49d68e3a1b9 100644 --- a/source/blender/makesdna/DNA_windowmanager_types.h +++ b/source/blender/makesdna/DNA_windowmanager_types.h @@ -548,12 +548,14 @@ enum { OPERATOR_RUNNING_MODAL = (1 << 0), OPERATOR_CANCELLED = (1 << 1), OPERATOR_FINISHED = (1 << 2), - /* add this flag if the event should pass through */ + /** Add this flag if the event should pass through. */ OPERATOR_PASS_THROUGH = (1 << 3), - /* in case operator got executed outside WM code... like via fileselect */ + /** In case operator got executed outside WM code (like via file-select). */ OPERATOR_HANDLED = (1 << 4), - /* used for operators that act indirectly (eg. popup menu) - * NOTE: this isn't great design (using operators to trigger UI) avoid where possible. */ + /** + * Used for operators that act indirectly (eg. popup menu). + * \note this isn't great design (using operators to trigger UI) avoid where possible. + */ OPERATOR_INTERFACE = (1 << 5), }; #define OPERATOR_FLAGS_ALL \ @@ -566,9 +568,10 @@ enum { /** #wmOperator.flag */ enum { - /** low level flag so exec() operators can tell if they were invoked, use with care. - * Typically this shouldn't make any difference, but it rare cases its needed - * (see smooth-view) */ + /** + * Low level flag so exec() operators can tell if they were invoked, use with care. + * Typically this shouldn't make any difference, but it rare cases its needed (see smooth-view). + */ OP_IS_INVOKE = (1 << 0), /** So we can detect if an operators exec() call is activated by adjusting the last action. */ OP_IS_REPEAT = (1 << 1), @@ -585,8 +588,10 @@ enum { /** When the cursor is grabbed */ OP_IS_MODAL_GRAB_CURSOR = (1 << 2), - /** Allow modal operators to have the region under the cursor for their context - * (the regiontype is maintained to prevent errors) */ + /** + * Allow modal operators to have the region under the cursor for their context + * (the region-type is maintained to prevent errors). + */ OP_IS_MODAL_CURSOR_REGION = (1 << 3), }; diff --git a/source/blender/windowmanager/intern/wm.c b/source/blender/windowmanager/intern/wm.c index c333d8149ed..a55f5af03d1 100644 --- a/source/blender/windowmanager/intern/wm.c +++ b/source/blender/windowmanager/intern/wm.c @@ -481,7 +481,7 @@ void WM_check(bContext *C) } if (!G.background) { - /* Case: fileread. */ + /* Case: file-read. */ if ((wm->initialized & WM_WINDOW_IS_INIT) == 0) { WM_keyconfig_init(C); WM_autosave_init(wm); @@ -491,7 +491,7 @@ void WM_check(bContext *C) wm_window_ghostwindows_ensure(wm); } - /* Case: fileread. */ + /* Case: file-read. */ /* NOTE: this runs in background mode to set the screen context cb. */ if ((wm->initialized & WM_WINDOW_IS_INIT) == 0) { ED_screens_init(bmain, wm); diff --git a/source/blender/windowmanager/intern/wm_init_exit.c b/source/blender/windowmanager/intern/wm_init_exit.c index 6cefbf0bae5..70e54e3e69d 100644 --- a/source/blender/windowmanager/intern/wm_init_exit.c +++ b/source/blender/windowmanager/intern/wm_init_exit.c @@ -163,15 +163,15 @@ static bool opengl_is_init = false; void WM_init_opengl(void) { - /* must be called only once */ + /* Must be called only once. */ BLI_assert(opengl_is_init == false); if (G.background) { - /* Ghost is still not init elsewhere in background mode. */ + /* Ghost is still not initialized elsewhere in background mode. */ wm_ghost_init(NULL); } - /* Needs to be first to have an ogl context bound. */ + /* Needs to be first to have an OpenGL context bound. */ DRW_opengl_context_create(); GPU_init(); diff --git a/source/blender/windowmanager/intern/wm_window.c b/source/blender/windowmanager/intern/wm_window.c index e93ffe48aba..6c90e0603a5 100644 --- a/source/blender/windowmanager/intern/wm_window.c +++ b/source/blender/windowmanager/intern/wm_window.c @@ -614,10 +614,10 @@ static void wm_window_ghostwindow_ensure(wmWindowManager *wm, wmWindow *win, boo } if (win->ghostwin != NULL) { - /* If we have no ghostwin this is a buggy window that should be removed. + /* If we have no `ghostwin` this is a buggy window that should be removed. * However we still need to initialize it correctly so the screen doesn't hang. */ - /* happens after fileread */ + /* Happens after file-read. */ wm_window_ensure_eventstate(win); WM_window_set_dpi(win);