Semantic Refactor is a refactoring tool based on Semantic parser framework
Clone or download
tuhdo Merge pull request #43 from whatacold/fix-gen-func-impl
[Fix #10] Fix issue of finding other file.
Latest commit 6f2c97d Jul 3, 2018

What is Semantic Refactor?

Semantic Refactor is a C/C++ refactoring tool based on Semantic parser framework.

Semantic is a package that provides a framework for writing parsers. Parsing is a process of analyzing source code based on programming language syntax. relies on Semantic for analyzing source code and uses its results to perform smart code refactoring that based on code structure of the analyzed language, instead of plain text structure.

NOTE: semantic-refactor only supports Emacs 24.4 or above at the moment.



  • Context-sensitive menu offers appropriate refactoring actions

  • Generate class implementation (also handles nested class and class template)

  • Generate class getters and setters

  • Generate function implementation (also handles function template)

  • Generate function prototype

  • Convert function to function pointer

  • Convert function to function parameter

  • Move semantic units (class, function, variable)

  • Extract function with proper type information

  • Precise local variable rename

More info and demos


  • Format whole buffer

  • Format a defun

  • Convert a sexpression into one line precisely

  • Convert a sexpression into multiple lines precisely

More info and demos


This package can be obtained from MELPA:

  • M-x list-packages
  • Move to srefactor and press i.
  • Press x to install.
  • Then, place this configuration in ~/.emacs.d/init.el or ~/.emacs:
    (require 'srefactor)
    (require 'srefactor-lisp)
    (semantic-mode 1) ;; -> this is optional for Lisp
    (define-key c-mode-map (kbd "M-RET") 'srefactor-refactor-at-point)
    (define-key c++-mode-map (kbd "M-RET") 'srefactor-refactor-at-point)
    (global-set-key (kbd "M-RET o") 'srefactor-lisp-one-line)
    (global-set-key (kbd "M-RET m") 'srefactor-lisp-format-sexp)
    (global-set-key (kbd "M-RET d") 'srefactor-lisp-format-defun)
    (global-set-key (kbd "M-RET b") 'srefactor-lisp-format-buffer)

NOTICE: If you only use Lisp formatting, you don't have to enable semantic-mode.


To use this package, a user only needs to use this single command: srefactor-refactor-at-point and semantic-mode activated. Based on the context at point, appropriate menu items are offered. When the menu opens up, the top line contains the tag at point, which is the context for offering appropriate refactor actions.

Key bindings of contextual menu:

  • 1..9 to quickly execute an action.
  • o to switch to next option, O to switch to previous option.
  • n to go to the next line, p to got to previous line.
  • q or C-g to quit.

You can hide the help message in the menu with by customizing srefactor-ui-menu-show-help and set it to nil.

(setq srefactor-ui-menu-show-help nil)